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create software installations 
without writing code. 
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and clicking. Simply answer the InstallShield Express 
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and your installs are 
created right before 
your eyes. It's that fast. 
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other things, you can display custom 
bitmaps, create icons and modify the .INI 
files or registry.There's even a feature 
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Need to demonstrate what your 
software can do? 


66 \Y/^ en y° u can t 

rr there to demonstrate 
a program yourself, Dan 
Brick tin’s demo-it! makes 
an effective stand-in 

PC Magazine 
April 11,1995 



Whether you’re in sales, marketing or development, demo-it! will show off your product when 
you’re not there. Need to give away demos at your upcoming trade show? Need to post demos 
on the Internet? Well now you can, with demo-it! 


No time to learn an authoring tool? No problem! 

You need to create a demo to show off your software, and you need 
it yesterday. You don’t have time to learn an authoring tool—all you 
want is to create an effective sales tool. Since demo-it! requires NO 
programming, has great online help and informative documentation, 
you can create a professional-looking demo quickly. 


Whatever kind of demo you want is what you get with demo-it! 

Quickly put together sales presentations. Produce electronic brochures for potential customers. Create 
self-running demos. Upload an interactive demo to the Internet. Supply your in-house staff with tutorials. 
Promote sales with disk-based advertising. 

Just look at some of the features: 

Version 2.0 of demo-it! is even more feature-rich than the best-selling Version 1.0. i / 

■ Enhanced special effects, including Implode and Explode t ' |Q[[.f||[[ / 
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TEcmicn. 


Is completely WYSIWYG—no need for you to worry about font support 
Works great on disk, CD-ROMS, Internet and online services 
Launches external programs 

Has rich text support—use several fonts and styles in one object 
Supports variables and conditions 
Creates a familiar “slide show” about your product 
Text, lines, buttons, pictures, rectangles, slides, overlays & underlays are easily created 
Supports events 

Has actions such as next slide, previous slide, go to slide, play a .WAV file, run a program, etc. 
Has a screen capture utility with many features 

Runs demos directly from floppy disk—no need for users to change their hard drives 
Comes with a freely distributable 170K runtime player 
Creates small, compact demos. 


CALL A ORDER TODAY! 

800 * 987*4929 

1163 SHREWSBURY AVE. • SHREWSBURY, NJ 07702 • VOICE: 908/389-0037 • FAX: 908/389-9227 • BBS: 908/389-9783 
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Validating data fields in a dialog box sounds easy, but it's hard to do nicely. Here’s how to 
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input focus notifications. 
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Ken you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov ax,2517h 

mov dx,offset int_17h_entry 

int 21 h : 

mov dx,offset data_4 ; 

mov ah ,9 

int 21 h 


mov dx,19h 
mov ah,31h 


DOS Services ah=function 25h 
; set intrpt vector al to ds:dx 
; ('Halt when ? printed.') 

; DOS Services ah=function 09h 
; display char string at ds:dx 


; DOS Services ah=function 31 h 
; terminate and stay resident 
; al=return code,dx=paragraphs 


int_17h_entry proc far 
pushf 

_ cmp al,3Fh 


; Push flags 


Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C, C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_l 0_video". And it's fully automatic. 
Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs. VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle", undocu¬ 
mented APIs, VxD functions and much more. 

Call now! 
1 - 800 - 648-8266 

Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 


4320 Stevens Creek Blvd., Suite 120-WD 
San Jose, CA 95129 408-296-4224 
FAX 408-296-4441 



I can’t resist — I’m going to beat this dead horse one more time: in the October 22 PC 
Magazine, Jim Seymour writes that NT will eventually provide “great speed improve¬ 
ments in complex apps, as they learn to spin out separate, concurrent-execution 
threads.” I can practically hear non-techie managers across the country reading that and 
exclaiming “Hey, we gotta start adding some threads!” Wrong, wrong, wrong. Take any 
compute-bound process and break it into five threads and what do you get? A slower 
process; slower by the amount of time wasted on context switching between those 
threads. Multithreading only makes sense in specific situations, but the industry pundits 
keep pushing the idea that it magically makes your app faster. They just don’t grasp the 
simple idea that there’s no such thing as “concurrent-execution threads” if your 
machine only has one physical CPU! (Look how fast multithreading has made 
Microsoft Exchange.) And let’s not even talk about the number of bugs and race condi¬ 
tions created by over-enthusiastic application of threads. AT At long last, Borland 
C++ includes MFC. I have no idea what caused Microsoft to relent from their reputed 
demand that Borland remove OWL from the box before they would sell them an MFC 
license, but I think it’s a good move for customers of both companies. My question of 
the month is this: is anyone in the world using Borland C++ to build MFC applica¬ 
tions? AT Our Web site at WWW .wdj .com now has a “utilities” page. It’s an attempt 
to provide easier access to some of the article code we publish that readers are most 
likely to want to grab and use in a hurry. For example, if you’ve been missing the func¬ 
tionality of good old dbwi n. exe under Win95, you’re going to want to grab the VxD and 
app described in Ton Plooy’s article last month. No need to download the entire issue’s 
code, just hop up to WWW . wd j . com, go to the utility page, and grab the single .zip file 
you need. AT In the November issue, I described an exciting new tool Borland has 
integrated with their IDE: Together/C++. Now, with a solid month of experience with 
the tool, I know more about what I like and don’t like. I still feel the object model edi¬ 
tor is pretty darn good; it lets you view, create, and maintain your object-oriented 
design even when your code is incomplete and far from compilable. Despite the fact 
that I often hop briefly into a DOS code editor and make changes, the object model edi¬ 
tor is happy to rescan the files and redraw the design; it does its job with minimal fuss 
and otherwise stays out of my way. AT On the other hand. I’m no longer particularly 
enthusiastic about the tool’s “scenario editor,” which (roughly) lets you depict pseudo¬ 
code for a given member function that graphically shows the objects involved in partic¬ 
ular path through the code. The problem is, unlike the object model editor, the scenario 
editor is graphically clunky (often too large to fit on a single screen in my experience) 
and too insistent that you do things its way (the canned set of pseudocode statements 
rarely let me depict the code as I want). AT What I really want instead of the prod¬ 
uct’s current scenario editor is a pseudocode editor that has the same laissez-faire phi¬ 
losophy that the object model editor has. I want to enter free-form lines of pseudocode, 
then be able to click on each line of pseudocode to create/view/modify the underly¬ 
ing source. I also want the tool to optionally check my source code, detect that I’ve 
made changes to it, and ask me if I want to update the affected pseudocode. What I 
envision ain’t easy to implement, but Together/C++ already has a good part of the task 
implemented. AT Upcoming theme issues in need of a few good articles include 
“debugging” and “software tools.” See my CDLINK utility in last month’s issue for an 
example of what I’m looking for. The trick is, can you make a useful utility for pro¬ 
grammers that fits in under 500 lines of code? 

Ron Burk, Editor 

70302.2566@compuserve.com 

http://ourworld.compuserve.com/homepages/RonBurk 
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Save months of TCP/IP programming! 


w* & 


Write a little code 


Fill in properties 

Login | File Transfer | Oirectoty | 


fciost Name: 

y*er: 

£asswoid: 

Account: 

Pdt: 


Jftp. distinct, c 


[anonymous 

F”"" 




OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UDP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

• POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

• FTP 

• rlogin 

•TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

• 32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLLs 

• C/C++ 

• OCXs 

• Access 

• VBX's 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 



Call now for 
30 minute 
Internet 
Delivery! 



Jk JUf . 

distinct 


The world leader in Internet development tools. 


u 408.366.8933 

World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


•Not all interfaces may be available for all protocols. Licensing fees required for redistribution. Distinct is a registered trademark and 30 minute Internet Delivery! and Visual Internet is a trademark of the Distinct Corporation. Copyright 1995 Distinct Corporation, 12900 Saratoga Avenue, Saratoga, CA 95070. All rights reserved. Specifications and delivery terms are subject to change without notice. 
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V. Ramachandran 



“I discuss the various 
ways you can 
implement field 
validation, discuss 
the pros and cons of 
each method, and 
present a solution for 
MFC applications that 
works with both 16- 
and 32-bit 
applications.” 


V. Ramachandran is a consultant with Imagine 
Technologies, Madras, India, where he develops 
Document Imaging and Work Flow solutions. He 
can be reached at raja @ imagine.globemail.com. 


Smart Field Validations for MFC 

A common problem in building a Windows user interface is how to handle user input 
data validation. With Windows, user input often involves dialog boxes, and dialog boxes 
often use edit controls that allow free-form input, which must then be checked for validity 
(e.g., was the text entered a valid phone number?) before the dialog box closes. Although 
this is conceptually simple, the details can be quite messy, requiring the programmer to 
understand the somewhat complicated algorithm Windows uses to move the input focus 
around in a dialog box. 

There are basically three techniques used to validate data in a typical Windows dialog box: 
Key-level validation: data is validatated after every keystroke. For example, if the only 
restriction on a particular field is that it be a positive number, you could subclass a standard 
edit control and force it to beep when any non-numeric keys are pressed. 

Field-level validation: validation is performed when the user tabs out of one control and 
into another. For example, you could detect when the input focus was leaving an edit control, 
and if the data in the control was invalid at that point, emit an error message and set the focus 
back to the edit control. 

Lazy validation: After the user triggers an action (say, by clicking a button), only the 
data required for the action is validated. For example, a dialog box might wait until the user 
presses the OK button, and only then check all the data fields in the dialog for validity. 

This article examines field-level validation. The program validates data when the user 
attempts to leave the field; if the data is invalid, the program forces the input focus to stay on 
the current control so that the user can correct the problem. I discuss the various ways you 
can implement field validation, discuss the pros and cons of each method, and present a 
solution for MFC applications that works with both 16- and 32-bit applications. 

Handling KillFocus Notifications 

One of the more common ways of providing field-level validation in programs written 
using the Windows SDK is to validate the data in the notifications sent by controls. The 
Windows edit control, for example, sends a EN_KILLFOCUS notification when the user tabs 
out of the edit control. This is a reasonable solution, but it has a few problems. 

First, not all 16-bit Windows controls generate notifications when they lose the input 
focus. (In Win32, all the new common controls generate the NM_KI LLFOCUS notification.) 

Second, the notification is sent after the focus change has occurred. If you want to set the 
focus back to the control (because the data is invalid), you must explictly call Set Focus (). This 
will generate more focus notifications, which can cause you trouble. For example, suppose the 
user tabs out of edit control A into edit control B. Your code detects that the data in edit control 
A is invalid, so you call SetFocus ( ) to move the input focus back to edit control A. But that 
sends a kill focus notification to edit control B, and if that control has invalid data (perhaps the 
validation check for B depends on the data entered in A), you can get into an infinite loop. 

Using MFC’s DDV_ Functions 

MFC provides a variety of data validation functions — prefixed with DDV_ — which get 
called whenever you call UpdateData (). Though this method might be easy to implement and 
is supported by ClassWizard, it cannot be used in non-trivial applications for several reasons: 

1. The DDV_ functions will not get called unless you call UpdateData (), which means that 
you need to figure out when to call them. Calling UpdateData () just to transfer data from 
the controls to variables will trigger the validations also, whether or not you want to trig¬ 
ger validation. 

2. You cannot selectively validate certain fields; validations for all fields are performed when 

you call UpdateData ( ). 

3. You cannot change the error notification mechanism. MFC displays a standard message 
box with predefined, non-intuitive messages. 

4. Finally, DDV_ functions also use SetFocus( ) to set the focus back to the control with 
invalid data, which will trigger other events when you don’t expect them. 
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These are trying times 
for software developers 



The market is tremendous. 

Millions of potential customers are constantly cruising the Internet looking for great software. 
The problem is, they want to try before they buy. So how do you let them sample your software, 
without fear of having it ripped off? 

TimeLOCK. 

TimeLOCK is the first commercially available toolkit that lets you create a fully functional 
version of your software for trial. It provides everything necessary to construct, customize, test 
and unlock trial applications. Your customers get to experience all the benefits of your product, 
while you get complete control of the trial administration. Plus TimeLOCK is royalty-free. You pay 
one fee and nothing more. 

In these times of try "before you "buy, you want the security, ease-of-use, 
and sales generating power of TimeLOCK. If you're providing demos from your website, 
planning a direct mail campaign, providing special offers or self-expiring beta release programs, 
call 1-800-773-8422 to place your order for TimeLOCK today. Or see us at www.timelock.com. 
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A Better Solution 

The problem with the above solutions is that they do the valida¬ 
tions after the focus has shifted, and then they SetFocus () back to 
the control in case the validation fails. Setting focus explicitly yields 
side effects such as extra kill focus notifications. You could avoid 
these side effects by performing the validation before the focus shift 
occurs. If the data is valid, allow the focus change to occur; other¬ 
wise, the focus remains in the erroneous field. 

Since no standard Windows message is triggered before a focus 
change occurs, you must set up an application-specific CBT hook 
which provides a HCBT_SETFOCUS notification whenever focus changes 
from one window to another. Windows sends this notification before 
the focus change occurs, and the hook function can indicate whether or 
not the focus change will be allowed. The solution, therefore, would be 
to perform the validation when receiving the HCBT_SETFOCUS notifica¬ 
tion, and to allow the focus to shift only if the data in the field is valid. 
Since the CBT hook lets you refuse the focus change before it actually 
occurs, you don’t have to manually set the input focus by calling 
SetFocus (), thus avoiding many of the problems mentioned earlier. 

Implementation Issues 

I chose to extend the MFC dialog box class CDi al og and created 
a new ZDi al og class with the logic for handling smart field valida¬ 
tion. The source code for ZDi a 10 g is in zdialog.h (Listing 1) and 
zdialog.cpp (Listing 2). 

Whenever the first ZDi a 1 o g window receives the WM_I NITDIALOG 
message, I set the Windows hook with a call to SetWi ndowsHookExt). 
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Listing 1: zdialog.h — Declarations for ZDialog 

j /* 

File: ZDialog.h 


Author: V.Ramachandran 


Date: 18 September, 1996 

*/ 


#ifndef _ZDialog_ 

i ijdefine_ZDi al og_ 


i: class ZDialog; // Forward declaration 


| class ZDialog : public CDialog 

1 f 

I 

I t 

j: public: 


ZDialog (); 

ZDialog (UINT nID, CWnd *pParent = NULL); 

ZDialog (LPCSTR lpszTemplateName, CWnd *pParent - 

NULL); 

1 public: 


virtual BOOL OnlnitDialog 0; 

BOOL SetCBTHook (); 

BOOL GetByPassState () const { return m_bByPas$; } 
void ByPassHook (BOOL bFlag = TRUE) 

j 

{ m_bByPass = bFlag; } 


void SetFocusNoHook (UINT nFieldID) 

r 


l 

m_bByPass - TRUE: 


:: SetFocus ( : : GetDlgltem (m_hWnd, 

nFieldID)); 

m bByPass - FALSE; 

} 


public; // Overrideables 


virtual BOOL IsValidationReqd ( HWND hWndLost, HWND 
virtual BOOL DoValidation (UINT nLostID) ; 
virtual void NotifyError (UINT nLostID); 

hWndGain); 

protected: 


afxjnsg LRESULT OnFocusChangeRequest (WPARAM wParam, 

LPARAM IParam); 


afx_msg void OnDestroy (); 


protected: 


static LRESULT CALLBACK CBTProc (int nCode, 


WPARAM wParam, LPARAM IParam); 

static int m_nNofInstances; 
static HHOOK m_h01dHook ; 
static ZDialog * m_pCurrentDlg ; 


protected: 


BOOL in_bByPass ; // If true, hook does nothing 

DECLARE MESSAGE_MAP( ) 

| DECLARE DYNAMIC (ZDialog) 

1 }; 


#define DO_FIELD_VALIDATION(fieldID ) 

\ 

if (! DoValidation (fleldID) ) { 

\ 

NotifyError (fieldID); 

\ 

SetFocusNoHook (fieldID); 

\ 

return; 

} 

\ 

S #define DO_FIELDJ1ALIDATION_RETURN(fieldlD, ret) 

\ 

if (!DoValidation (fieldID)) { 

\ 

NotifyError (fieldID); 

\ 

SetFocusNoHook (fieldID); 

\ 

return ret; 

} 

\ 

| #endif // _ZDialog_ 



Listing 2: zdialog.cpp — The ZDialog implementation 


/* 

File: ZDialog.cpp 
Author: V.Ramachandran 
Date: 18 September, 1996 

*/ 

#include "stdafx.h" 

#include "zdialog.h" 

#ifdef _DEBUG 
#undef THIS_FILE 

static char BASED.CODE THIS_FILE[] - _FILE_ 

#endif 
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Listing 2: zdialog.cpp — continued 


♦define WM_USER_FOCUS_CHANGE (HMJSER+25) // 25 arbitrary 

IMPLEMENT_DYNAMIC (ZDialog, COialog) 

♦define new DEBUGJEH 

int ZDialog::m_nNofInstances - 0; 

HH00K ZDialog::m_h01dHook - NULL; 

ZDialog * ZDialog::m_pCurrentDlg - NULL; 

BEGIN_MESSAGE_MAP(ZDialog, CDialog) 

//{{AFX_MSG_MAP(ZDialog) 

0N_WM_DESTR0Y() 

ON_MESSAGE(WM_USER_FOCUS_CHANGE, OnFocusChangeRequest) 

//})AFX_MSG_MAP 
END_HESSAGE_MAP() 

ZDialog:: ZDi al og 0 : CDi al og 0, OByPass (FALSE) 

( 

} 

ZDialog::ZDialog (LPCSTR IpszTemplateName, CWnd *pParent) 

: CDialog (IpszTemplateName, pParent), m_bByPass (FALSE) 

( 

) 

ZDialog::ZDialog (UINT nID, CWnd *pParent) 

: CDialog (nID, pParent), m_bByPass (FALSE) 

{ 

} 

/****************************************************************/ 
II OnlnitDialog 

// If this is the first instance, set the windows hook. 
/****************************************************************/ 

BOOL ZDialog::On InitDialog 0 
( 

BOOL bRet - CDialog::OnInitDialog 0; 


I unhook the hook when the last dialog is destroyed. CBTProc() is 
the hook procedure whose address I pass in the call to 
SetWindowsHookEx( ). I must make this function a static member 
because Windows specifies the exact prototype for the CBTProc() 
function. Non-static member functions have an implicit this point¬ 
er as the first parameter, whereas CBTProc () does not understand 
the this pointer. Since it is a static member function, I need to be 
able to identify which object to deal with when I receive a notifica¬ 
tion. Thus, I use the HCBT_ACT IVATE notification, which is sent 
whenever a window is about to be activated. If the activated window 
is of type ZDialog, I store the pointer in m_pCurrentDl g, and all fur¬ 
ther HCBT_SETFOCUS notifications are related to this dialog. 

When I get a HCBT_SETFOCUS notification, I first check to see if 
iTLpCurrentDl g is non-NULL. If it is non-NULL, I call out to a virtual 
function IsVal i dati onReqd(), which returns TRUE if validation is 
required for the control losing focus. If validation is required, I post 
a WM_USER_FOCUS_CHANGE message to the m_pCurrentDl g window 
and return TRUE to indicate that the focus shift is to be disallowed. I 
could do the validation in this function itself, and return the correct 
value instead of returning TRUE and explicitly calling SetFocus(), 
but I thought it was best to move the validations out of the hook 
procedure code. 

In the WM_USER_FOCUS_CHANGE handler, I call out to another virtual 
function DoVal i dati on (), which returns TRUE if validation is success¬ 
ful and FALSE otherwise. If validation is successful, I set the 
m_bByPass flag to TRUE, call SetFocus () explicitly to set the focus to 
the window gaining focus, and set m_bByPass back to FALSE again. In 
the CBTProc! ), I first check if m_bByPass is TRUE; if so, I call the next 
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hook procedure, bypassing the validation 
checks. If validation fails, I call out to anoth¬ 
er virtual function Noti fyErrort ) and retain 
the focus in the current field. 

The default version of 
IsValidationReqdO returns TRUE if both 
the window losing focus and the window 
gaining focus are children of 
m_pCurrentDlg; else, it returns FALSE. The 
default version of DoVal i dati on ( ) returns 
TRUE; the default version of Noti fyErrort) 
does nothing. 

Overriding Virtual 
Functions 

To use the smart field validation dis¬ 
cussed above, you must derive your dialog 
class from ZDial og instead of CDi al og and 
override the virtual functions discussed 
above. In IsValidationReqdO, call the 
base class version first and if the base class 
version returns FALSE, return FALSE. Else, 
add your own logic to see if validation is 
required. In the sample code, 
CSmartValidationDlg::IsValidati onReqd 
() returns FALSE if the window gaining focus 
is the Cancel button. You can write your vali¬ 
dation logic in DoValidationO with a 
swi tch statement for all the fields where val¬ 
idation is required. Since DoVal i dati on ( ) is 
a public member function, you can also call it 
at anytime for explicitly validating any 
field. The error notification can be cus¬ 
tomized by overriding NotifyError (). In 
CSmartValidationDlg::NotifyError!), I 
beep and display the field which caused the 
error in a static text control. You might want 
to do something more useful. The 
SetFocusNoHookl ) function will set focus 
without invoking the hook procedure and, 
therefore, the field validation. 

Caveats 

Note that when the user hits returns on a 
non-pushbutton control (in 16-bit Windows), 
the default button is selected. Currently, there 
is no focus change, so you will have to do the 
validations for the required fields explicitly. 
For programming ease, I have added two 
macros — D0_F I E LD_VALI DAT I ON and 
D0_FIELD_VALIDAT 10N_RETURN — that 
check for field validation, appropriately call 
NotifyErrort ) and SetFocusNoHookt), 
and return from the function. I demonstrate 
the use of these macros in 
CSmartValidationDlg: :0n0K( ). Using 
these macros to validate the fields will keep 
all the field validation logic in one place 
(DoVal i dati on ()). 
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Listing 2: zdialog.cpp — continued 


if (m.nNoflnstances — 0) { 
if HSetCBTHook 0) { 

AfxMessageBox ("CBT Hook could not be installed.”): 
return bRet; 

} 

} 

m.nNoflnstances ++; 
return bRet; 

} 

j****************************************************************j 

II OnDestroy - remove the hook if this is the last instance. 

J **************************************************************** j 

void ZDialog::OnDestroy 0 
( 

if ((--m.nNoflnstances — 0) && (m_h01dHook)) 
UnhookWindowsHookEx (m.hOldHook); 

CDialog: :OnDestroy 0; 

) 

j **************************************************************** J 

// CBTProc - the hook function. 

// See CBTProc SDK documentation for parameters/return value. 

// Handles focus change notifications, by first checking if 
// validation is required. If so, posts a user message and 
// returns TRUE to disallow focus shift. In the user message 
// handler, do the validation and explicitly SetFocus. 

/**************************************************************** j 


II Mechanism to opt out of hook processing. 

if ((m_pCurrent01 g) U (m_pCurrentDlg->m_bByPass)) 

return Cal 1NextHookEx (m_hOT dHook. nCode, wParam, 1 Pa ram); 

// If the to-be-activated window is a ZDialog, store it in 
// m_pCurrentDlg 

if (nCode -- HCBT.ACTIVATE) { 

CWnd *pDlg - CWnd::FromHandlePermanent ((HWND)wParam); 
if (tpDlg) &S (pDlg->IsKindOf (RUNTIME.CLASS (ZDialog)))) 
»_pCurrentDlg - (ZDialog *)pDlg; 

else 

iLpCurrentDlg - NULL; 

} 

else if (nCode — HCBT_SETFOCUS) { 
hWndGain - (HWND)wParam; 

#1fdef WIN32 

hWndLost - (HWND)1 Pa ram; 

#else // Win16 

hWndLost - (HWND)LOWORD (IParam); 

#endif 

// Check if the dialog requests validation. If so, post a 
// user defined message and disallow focus shift. 

if ((m_pCurrentDlg) SS (m_pCurrentDlg->IsValidationReqd 
(hWndLost, hWndGain))) ( 

m_pCurrentDlg->PostMessage (WM_USER_FOCUS_CHANGE, 

(WPARAM)hWndLost, (LPARAM)hWndGain); 
return TRUE; // Disallow focus shift 

} 

} // If HCBT.SETFOCUS 

return CallNextHookEx (m_h01dHook, nCode, wParam, IParam); 


#1 fdef WIN32 // .export not required for Win32 

fdeflne .export 

#endif 


LRESULT CALLBACK .export ZDialog;:CBTProc (int nCode, 

WPARAM wParam, LPARAM IParam) 


{ 


HWND hWndLost, hWndGain; 



SftTabs/DLL 2.1 

Tab Control for Windows 


/ 

/ 

/ 

/ 

/ 


Use with C, C++ 
(MFC, OWL) and 
other DLL call 
capable languages 

MFC and OWL 
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Supports Windows 
3.1, Windows NT 
and Windows 95 

Includes design 
application for easy 
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ment 

Supports AppStudio, 
Resource Workshop 
and SDK dialog 
editors 


M 


16-bit and 32-bit DLL-based 
control for Visual C++ and 
Borland C++ 
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• over 50 different styles 

• tabbed dialogs and windows 

• multi-line tab labels 

• color support for tab labels 

• icons, bitmaps on tabs 

• create Wizard-style dialogs 
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• scrollable tabs 
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• extensive API 

• includes 16 & 32-bit DLLs 

• easy to use 
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Call today for your free demo! 

SntfML WnMl (201)366-9618 

Not The Industry Standard FAX (201) 366-3984 

11 Michigan Ave 

Wharton, nj 07885 http://www.softelvdm.com 


/**************************************************************** j 

II IsValidationReqd - ZDialog virtual function 
// Parameters; Handle of window losing focus, and window 
// gaining focus. 

// Return TRUE if validation is requried for the window losing 
// focus. This version returns TRUE if both the child windows 
// belong to the dialog. In derived versions, remember to 
// call base class first. 

j****************************************************************j 

BOOL ZDialog::IsValidationReqd (HWND hWndLost, HWND hHndGain) 

( 

if ((;:GetParent (hWndGain) -- m.hWnd) S& 

(::GetParent (hWndLost) — m.hlfnd)) 
return TRUE; 

else 

return FALSE; 

) 

J **************************************************************** j 

II DoValidation - ZDialog virtual function 
// Parameter: ID of child window losing focus. 

// Return: TRUE if validation succeeds, FALSE otherwise. 

// This version just returns TRUE. 

j****************************************************************j 

BOOL ZDialog::DoValidation (UINT nLostID) 

( 

return TRUE; 

} 

/**************************************************************** j 

II NotifyError - ZDialog virtual function 
// Called whenever field validation fails. 

// Parameter: ID of child window losing focus. 

I ****************************************************************i 

void ZDialog;:NotifyError (UINT nLostID) 

{ 

) 

j****************************************************************i 

// OnFocusChangeRequest - WM.USER.FOCUS.CHANGE handler 
// Parameters: hWndLost - wParam, hWndGain - IParam 
// Calls out to DoValidation virtual function. If validation 
// succeeds, set focus to window gaining focus explicitly. 

II Else call NotifyError. 

/**************************************************************** J 

LRESULT ZDialog::OnFocusChangeRequest (WPARAM wParam, 

LPARAM IParam) 
f 

HWND hWndLost - (HWND)wParam; 

HWND hWndGain - (HWND)lParam; 

#ifndef WIN32 
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The Sample Code 

The electronic distribution of the code (see Table of Contents for 
availability) contains a sample program generated using the Visual 
C++ 1.52 AppWizard. The dialog box code is in smartval .h and 
smartval.cpp. smartval.cpp overrides the ZDialog virtual func¬ 
tions as explained in the previous section. The main file 
generic.cpp has the message maps to handle the menu commands 
that display the dialog box. The code has been compiled and tested 
using VC++ 1.52 (Winl6) and VC++ 4.0 (Win32) — generic.mak 
and generic32 .mak are the two makefiles. 


Conclusion 

Though I use the field validation technique with dialog boxes, it 
can be used in form views also. You can derive a ZFormVi ew class 
from CFormVi ew, and set the windows hook in Onlni ti al Update() 
instead of Onlni tDia 1 og(). There are many ways to implement 
field validation, and I have presented one of the ways. This is defi¬ 
nitely useful for dialogs/formviews which require that every field be 
validated before the user proceeds to the next. □ 


Listing 2: zdialog.cpp — continued 


UINT nLostID - ::GetWindowWord (hWndLost, GWW_ID); 

#e 1 se 

UINT nLostID - ::GetWindowLong (hWndLost, GWl_ID); 
fendif 

if (DoVal Nation (nLostID)) { // Call out to virtual 
m_bByPass - TRUE; // Bypass hook code 

:;SetFocus (hWndGain); 

m_bByPass - FALSE; // Reset bypass flag 

} 

else 

NotifyError (nLostID); 
return 0; 


finclude "windowsx.h” // For GetlnstanceModule! 

j****************************************************************j 

II SetCBTHook • sets the CBT hook. Call only once. Otherwise 
// latest hook is activated. 


// Returns: TRUE if hook is set, FALSE otherwise. 

/**************************************************************** j 

BOOL ZDialog::SetCBTHook 0 
t 

ASSERT UmjNoflnstances); 

#ifdef WIN32 

CWinThread ‘pThread - AfxGetThread 0; 
mJiOldHook - SetWindowsHookEx (WH_CBT. 

(H00KPR0C)ZDialog::CBTProc, 

GetlnstanceModule (AfxGetlnstanceHandle 0), 
(DWORD)pThread->m_nThreadID); 

i/else 

m_h01dHook - SetWindowsHookEx (WH_CBT, 

(HOOKPROC)ZDialog::CBTProc, 

GetlnstanceModule (AfxGetlnstanceHandle 0), 
GetCurrentTask 0); 

fend if 

return (mJOldHook) ? TRUE : FALSE; 

} 

//End of File 
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MFC 


Serialize MFC Objects across the 
Networks 

The Internet provides a wonderfully efficient way of sharing information with the world. 
If you stick to existing protocols such as FTP and HTML, you can write one side of the 
client/server equation without concern for the hardware/software platform on the other side 
of the equation. Using languages such as Java, you can even write platform-independent 
code, albeit with some limits in functionality. These solutions work well when you have lim¬ 
ited knowledge of your users and their equipment. However, if you know that all your users 
are running Windows, and you control both the client- and server-side solutions, you can use 
more efficient and convenient techniques. This article examines an easy method of develop¬ 
ing complex applications that are linked interactively across a network using MFC. 

Transmittable Objects 



Sending information across the net using MFC is greatly simplified by MFC’s CSocket 
class, which makes it easy to send a stream of data to the other side, reconstruct it, and 
process the data stream. By defining different packet structures, you could send over an 
unlimited number of different types of information and requests. A problem with this 
approach is that it can grow into a complicated switch statement (one case per packet type) 
on the sending end, matched by an equally complex swi tch statement on the receiving end. 
Managing both a client and a server version of that switch statement could quickly become 
a monstrous affair. MFC, with a little tweaking, can offer a simplified solution. 

Any C++ programmer worth his salt would instantly recognize that the statement “defin¬ 
ing different packet structures” is equivalent to “defining different classes.” You need to be 
able to send a class object from one end of the network connection to the other, and have the 
receiver invoke some method in that class object to perform some useful task. MFC already 
provides a method of turning a class into a stream of data through its persistent COb j ect base 
class. By adding a simple virtual method, you can define a class that also knows what to do 
with itself once it arrives at its destination. I have created a CNetObject class definition that 
I use as the base class for all objects I want to be transmittable: 

class CNetObject : public CObjectl 
public: 

DECLARE_SERIAL( CNetObject); 

CNetObject!) : CObjectO {} 

void Serialize(CArchive& ar); 

virtual void DoAction(CObjectSocket * pOS); 

}; 


“MFC already 
provides a method of 
turning a class into a 
stream of data 
through its persistent 
CObject base class. 
By adding a simple 
virtual method, you 
can define a class 
that also knows what 
to do with itself once 
it arrives at its 
destination.” 


Using the DECLARE_SERIAL and the IMPLEMEN T_S E RIA L macros, you can take advantage of 
all of MFC’s built-in object streaming code. In your derived class, you override the 
Serialized virtual function (see the MFC documentation for a complete description of this 
function) to define what object data gets sent and in what order. Remember, MFC persis¬ 
tence requires your class to have a default constructor that takes no parameters. The virtual 
method DoActi on( ) will be defined differently by each object type and called immediately 
after the object is received across the network. The pointer to CObjectSocket (described 
later) is passed to DoActi on () as a convenience. This design lets you encapsulate not only 
the data, but the functionality of the object itself in the transmission. 

For this scheme to work, both the client software and the server software must define each 
transmittable class identically. The easiest way to ensure this is by implementing all transmit¬ 
table classes in a single set of source files that both the client and server software share. 

Figure 1 shows a simple example of creating a transmittable object class, named 
CNetMessage, by deriving from CNetObject. The code demonstrates an object that displays 
a message box after transmission. CNetMessage: : DoActi on () method first displays the mes¬ 
sage, then deletes itself. The overloaded input (<<) and output (>>) operators handle a variety 
of data types, making it easy to write aSerializeO function that serializes even complicat¬ 
ed objects. You can even create classes that contain other classes and have them transmitted 
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correctly. There are some limits to this technique, which I will point 
out later in this article. 

Building the Send/Receive Object 

Defining the transmittable objects is only part of the battle. 
You need an easy method of transmitting the objects from one 


Figure 1: Defining a transmittable object index 


II In the header file 

class CNetMessage : public CNetObject! 

public: 

CString m_SMsg: 

DECLARE_SERIAL(CNetMessage) 
CNetMessageO : CNetObjectl) {} 
CNetMessage!LPCTSTR IpMsg) 

{m_SMsg - IpMsg;) 
void SerializeCCArchive& ar); 
void DoActiontCObjectSocket * pOS); 


side to the other. As I mentioned earlier, CSocket is a good start¬ 
ing point. 

As Figure 1 shows, your Serialized function is passed a 
CArchive object, which represents the storage medium the serialized 
data will be written to. A CAr chi ve object is always associated with a 
CFi 1 e object (or an object derived from CFi 1 e) that handles the actual 
reading or writing of serialization data. Fortunately, MFC supplies the 
CSocketFi 1 e class, which you can associate with a CArchi ve object so 
that it communicates with a CSocket instead of a disk file. 

A CArchi ve object can be in either input or output mode, but not 
both. To allow for full two-way communication, you need an 
archive for each direction of communication. With some simple 
C++ organizational skills, you can quickly derive a class that con¬ 
tains one CSocket, one CSocketFile, and two CArchives that 
would handle the necessary communications. Unfortunately, if you 


//In the source file 

IMPLEMENT_SERIAL(CNetMessage, CNetObject, 1) 
void CNetMessage::Serialize(CArchve& ar){ 
CNetObject::Serialize(ar); 
if (ar->IsStoring()){ 
ar « m.SMsg; 

1 

else! 

ar » m.SMsg; 


1 

void CNetMessage::DoActiontCObjectSocket * pOSK 
AfxMessageBox(m_SMsg); 
delete this; 

1 
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Listing 1: csockobj.h — Declaration of CObjectSocket 


\ #1fndef CSOCKOBJ.H 
/(define CSOCKOBJ.H 

//Forward Declarations 
class CObjectSocket: 
class CNetObject; 

class CSocketArchive : public CArchive{ 
public: 

CSocketArchivetCFile * pFile, UINT nMode, int nBufSize—4096): 

CArchive(pFi1e, nMode, nBufSize) {}; 
void ClearlndexO; 


: public CSocket! 
u.pMaster; 


class CSocketSlave 
CObjectSocket * 
public: 

CSocketSlave(CObjectSocket * pOS); 
void OnReceive(int nErrorCode); 
void OnClosetint nErrorCode); 


class CObjectSocket! 
protected: 

friend class CSocketSlave; 

CSocketSlave * m.pSocket; 

CSocketFile * m.pSocketFile; 

CSocketArchive * m.pArchivein, 

* m.pArchi veOut; 
void ClearNewPointersO; 
void ReadPendingO; 
public: 

CObjectSocket!); 

-CObjectSocket!); 

BOOL IsConnected!) {return (m_pSocket I- NULL);} 

BOOL Connect!LPCTSTR IpszHostAddress, UINT nHostPort); 
BOOL ConnecttCSocket * pSocket); 
void Disconnect!); 

BOOL SendObjecttCNetObject * pObj); 

virtual void OnForcedDropO; 

virtual void ConnectionClosedO; 

virtual void ErrorMemoryO; 

virtual void ErrorArchivetint nErrorCode); 

virtual void ErrorFi1e(int nErrorCode); 

virtual void ErrorSocket!int nErrorCode); 


class CNetObject : public CObject! 
public: 

OECLARE.SERIAL!CNetObject) 

CNetObject!) {}; 

virtual void DoAction(CObjectSocket * pOS); 
void Serialize(CArchive& ar); 


#endif //CSOCKOBJ.H 
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attempt to build such a class, you run into a serious problem with 
the internal design of CArchi ve. 

CArchive Details 

CArchi ve was developed for disk-based storage and assumes you 
are saving or loading all the objects in the “archive” at once. It was 
not designed for continuous transmission of different objects that 
may or may not be in memory at any given time. When storing, 
CArchive keeps a list of pointers to all previously stored objects. 
When it encounters a pointer to an object that has already been 
stored, CArchive stores only an index to that object instead of an 
additional copy. This is necessary to maintain the integrity of the 
object structures from store to load. If you have only one object at 
store time, you certainly would want only 
one object after a load. The problem is that 
network communications are usually ongo¬ 
ing, and objects that have passed through 
CArchi ve previously are not necessarily still 
in existence later on. This would produce an 
exception very quickly when pointers are 
reused, not to mention the ever-growing list 
of past object pointers sent or received. 

Ideally, CArchive would consider each 
object you send as a different store or 
retrieve session. You would still like 
CArchi ve’s object indexing scheme to work 
with member objects contained within the 
object you are sending. One solution would 
be to destroy, then recreate, the CArchive 
each time you want to send or receive an 
object. You can avoid this overhead if you 
spend some time tracing through the 
CArchi ve code; it is much more efficient to 
just empty the CArchive index each time 
you receive or send an object. I have creat¬ 
ed a class called CSocketArchi ve that has a 
method called Cl earIndex () that resets the 
CArchi ve object so it can be used for a new 
object. The declaration of CSocketArchi ve 
is in csockobj . h (Listing 1); the definition 
is in csockobj . cpp (Listing 2). 

In CSocketArchive::ClearIndex(), I 
maintain the integrity of the index list by 
making sure that the first entry is NULL as 
CArchi ve expects. If the system is storing, 
the process is a little bit more difficult 
because the access keys to the object list are 
the pointers themselves. Since I didn’t have 
access to CArchi ve’s pointers, and didn’t 
want to keep a separate list of objects that 
had been stored, I used a RemoveAl 1 () call 
and then re-added the NU LL pointer key with 
an index value of 0. 

You also have to extend the CSocket 
class to recognize the receipt of data and 
the closure of the connection. I do this by 
deriving a new class (CSocketSl ave) from 
CSocket, and overriding the virtual func¬ 
tions OnReceiveO and OnCloseO. You 


will find more information on these virtual functions in the MFC 
documentation under CAsyncSocket (the root of CSocket’s power). 
CSocketSlave’s constructor takes a pointer to the master control 
object CObjectSocket (described next), to facilitate inter-object 
communication during socket events. Now you can build a master 
class that fully handles the object communications. 

CObjectSocket 

CObjectSocket is a fairly simple organizational class. It gets 
most of its functionality from its members CSocketSl ave, 
CSocketFile, and two CSocketArchives. I added simple virtual 
error control and dropped-connection functions that currently dis¬ 
play an informative message, then drop the connection. You can 
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Listing 2: csockobj.cpp — Implementation of 
CObjectSocket 


(/include "stdafx.h" 

//include "csockobj.h” 

////////////////////////////////////////////////// 

// CSocketArchive 

void CSocketArchive::ClearlndexOL 
if (IsStoring()){ 

if (m_nMapCount > 1){ 

m_pStoreMap->RemoveAl 10; 
m_pStoreMap->SetAt(NULL,(void*)(DWORD)0); 
m_nMapCount - 1; 


el se{ 

while OnjMapCount > 1){ 
mjMapCount--; 

m_pLoadArray->RemoveAt(m_nMapCount); 

) 

) 

) 

////////////////////////////////////////////////// 
// CSocketSlave 

void CSocketSlave;;OnReceive(int nErrorCodeK 
ASSERK m_pMaster); 
if (nErrorCode — 0){ 

DWORD dwBytes; 

IOCtl(FIONREAD, SdwBytes); 

//Don't read if nothing is there 
if (dwBytes > 0){ 

m_pMaster->ReadPending(); 

} 

return; 

) 

m_pMaster->ErrorSocket(nErrorCode); 


CSocketSlave::CSocketSlaveCCObjectSocket * pOS){ 
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ASSERT(pOS); 
m_pMaster - pOS; 

} 

void CSocketSlave::OnClose(int nErrorCodelf 
ASSERT(m_pMaster): 
m_pMaster->ConnectionClosed(); 


////////////////////////////////////////////// 
// CSocketObjects 
CObjectSocket;:CObjectSocket(){ 
m_pSocket - NULL; 
m_pSocketFi 1 e - NULL; 
m_pArchiveIn - NULL; 
m_pArchiveOut - NULL; 

} 

CObjectSocket::~CObjectSocket(){ 

Disconnect); 

) 


BOOL CObjectSocket:;Connect(LPCTSTR IpszHostAddress, 

UINT nHostPortH 

ASSERK1pszHostAddress); 
try { 

mjSocket - new CSocketSlave(this); 

if (!m_pSocket->Create()){ 
delete m_pSocket; 
iri_pSocket - NULL; 
return FALSE; 

) 

if (!m_pSocket->Connect(1pszHostAddress,nHostPort)){ 
delete m_pSocket; 
m_pSocket - NULL; 
return FALSE; 

} 

m_pSocketFi 1 e - new CSocketFi1e(m_pSocket); 
m_pArchivein - 

new CSocketArchive(m_pSocketFile.CArchive::1oad); 
m_pArchiveOut - 

new CSocketArchive(m_pSocketFile.CArchive::store); 
return TRUE; 


catch (CMemoryException * me){ 
me->Delete(); 
ClearNewPointersO; 
ErrorMemoryO; 
return FALSE; 

) 

catch (CArchiveException * ae){ 
ae->Delete(); 
ClearNewPointersO; 
return FALSE; 

} 

catch (CFi1eException * fe){ 
fe->Delete(); 
ClearNewPointersO; 
return FALSE; 


void CObjectSocket::ClearNewPointers(){ 

if (m_pSocket){ 
delete m_pSocket; 
m_p$ocket - NULL; 

} 

if (m_pSocketFi 1 e){ 

delete m_pSocketFile; 
m_pSocketFi 1 e - NULL; 

) 

if (m_pArchivein){ 
delete m_pArchivein; 
m_pArchivein - NULL; 

} 

if (m_pArchiveOut){ 
delete m_pArchiveOut; 
m_pArchiveOut * NULL; 

} 

) 


BOOL CObjectSocket::Connect(CSocket * pSocketlf 
ASSERT(pSocket); 
tryf 

m_pSocket - new CSocketSlave(this); 
if (!pSocket->Accept(*m_pSocket)){ 
delete m_pSocket; 
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override these functions to provide your own error handling. 
Whenever the class automatically drops the connection via its error 
control, it informs the programmer by calling the virtual function 
OnForcedDropl ) to allow for other programming cleanup. 

A large part of the CObjectSocket class mimics the simple con¬ 
nection and disconnect routines of CSocket (plus archive creation 
and some exception handling). These are fairly simple to use and 
are well documented by Microsoft. The only functions of real note 
are ReadPending () and SendObject(). 

ReadPendi ng() is automatically called by the input socket when 
data arrives to be read. Minus its exception handling, it looks like this: 

void CObjectSocket::Read Pending() 

1 

CNetObject * pNObj = NULL; 
do { 

*m_pArchive!n >> pNObj; 


m_pArchiveIn->ClearTndex(); 
pNObj->DoAction(this); 

} while (!m_pArchivein 

-MsBufferEmptyO); 

} 

The sent object is reconstructed automatically by the CArchi ve object, 
the object index is cleared to prepare for the next object, then the 
object invokes its DoActi on () method. CObjectSocket passes a point¬ 
er to itself to DoActi on (). This lets you write CNetOb jects that per¬ 
form some action and then easily respond back across the net with an 
answer or status object if necessary. As with the example in Figure 1, 
the object may need to delete itself, since this method does not clean 
up the memory. The do-wh i 1 e loop is necessary because of the buffer¬ 
ing nature of CArchi ve. You may receive only one read notification 
when two or more objects are pending in CArchi ve’s internal buffer. 
The loop ensures that all objects are read before exiting, thus delaying 


Listing 2: csockobj.cpp — continued 


m_pSocket - NULL; 
return FALSE: 

} 

m_pSocketFi1e - new CSocketFi1e(m_pSocket): 
m_pArch1vein - 

new CSocketArchive(m_pSocketFile.CArchlve::1oad); 
m_pArchiveOut - 

new CSocketArchive(m_pSocketFi1e,CArchive::store); 
return TRUE; 

} 

catch (CMemoryException * me)C 
me->DeleteC); 

ClearNewPointersO; 


ErrorMemoryi); 
return FALSE; 

} 

catch (CArchiveException * ae) { 
ae->Delete(); 
ClearNewPointersO; 
return FALSE; 

} 

catch (CFi1eException * fell 
fe->DeleteO; 
ClearNewPointersO; 
return FALSE; 
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Listing 2: csockobj.cpp — continued 


void CObjectSocket:: Disconnect() { 
if (IsConnectedOH 

m_pArchiveOut->Abort(); 
delete m_pArchiveOut; 
m_pArchiveOut - NULL; 
m_pArchiveIn->Abort(); 
delete m_pArch1vein; 
m_pArchivein - NULL; 
delete m_pSocketFi1e; 
m_pSocketFi1e - NULL; 
m_p$ocket->ShutDown(); 

BYTE Buffer[50D; 

while (m_pSocket->Receive(Buffer,50) > 0); 
delete m_pSocket; 
m_pSocket - NULL; 

) 

} 

void CObjectSocket::ReadPending(){ 

ASSERKIsConnected()); 

CNetObject * pNObj - NULL; 
try { 

do{ 

*m_pArchiveIn » pNObj; 
m_pArchiveIn->Clea rlndex(); 
pNObj->DoActionithis): 

) 

while (!m_pArchiveIn->IsBufferEmpty()); 

) 

catch (CArchiveException * ae)( 

ErrorArchive(ae->m_cause): 
ae->Delete(); 

} 

catch (CFi1eException * felt 
ErrorFi1e(fe->m„cause); 
fe->Delete(); 

} 

catch (CMemoryException * me){ 

ErrorMemory!); 
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- Serial Driver 

- Parallel Port Driver 
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• Extensive C++ Class Library 

• Real World Usable Samples 

• Comprehensive Documentation 

• A 300+ Page Manual 

• An Easy to Follow Tutorial 
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me->Delete(); 


1 

BOOL CObjectSocket::SendObject(CNetObject * pNObj){ 

ASSERT(pNObj); 

ASSERKIsConnectedE)); 
try{ 

if disconnected!)) return FALSE; 

*m_pArchiveOut « pNObj; 
m_pArchiveOut->Flush(); 
m_pArchiveOut->CTear Index!); 
return TRUE; 

} 

catch (CArchiveException * ae){ 

ErrorArchive(ae->m_cause); 

ae->Delete(); 

return FALSE; 

} 

catch (CFiTeException * fe){ 

ErrorFile(fe->m_cause); 
fe->Delete(); 
return FALSE; 



void CObjectSocket::OnForcedDrop(){ 

//Do nothing - programmer defined 

} 

//define OSERR_DROP _T("Remote Disconnect Detected! Disconnecting") 
//define OSERR_MEMORY _T("Out of Memory! Disconnecting") 

//define OSERR_FILE _T("Socket File Error! Disconnecting") 

//define OSERR_SOCKET _T("Socket Error Detected! Disconnecting") 
//define OSERR_OBJECT \ 

_T("Bad Object Structure Transfered! Disconnecting") 

void CObjectSocket::ErrorMemory(){ 

Disconnect!); 

OnForcedDropO; 

AfxMessageBox!OSERR_MEMORY); 

} 

void CObjectSocket: :ErrorArchive(int nErrorCodeH 
Disconnect!); 

OnForcedDrop!); 
switch (nErrorCode){ 

case CArchiveException::badlndex; 
case CArchiveException::badClass: 
case CArchiveException::badSchema: 

AfxMessa geBox!OSERR_OBJECT); 
break; 
default; 

AfxMessageBox!OSERR_FILE); 

} 

} 

void CObjectSocket::ErrorFile(int nErrorCodeH 
Disconnect!); 

OnForcedDropO; 

AfxMessageBox(OSERR_FILE); 

} 

void CObjectSocket:: ErrorSocketdnt nErrorCodeH 
Disconnect!); 

OnForcedDropO; 

AfxMessageBox(OSERR_SOCKET); 

} 


void CObjectSocket;:ConnectionClosed(){ 

Disconnect!); 

OnForcedDropO; 

AfxMessageBox(OSERR_DROP); 

} 

//////////////////////////////////////////////////// 
// CNetObject 

IMPLEMENT_SERIAL(CNetObject, CObject, 1) 

void CNetObject::Serialize(CArchive8 ar){ 

CObject ::Serialize(ar); 

} 


void CNetObject::DoAction!CObjectSocket * pOSH 
ASSERT!FALSE); 

// This member should be overridden in the 
// programmer defined CNetObject 

} 

//End of File 
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transmission of obj ects. N otice that Re a d P e n d 1 n g 0 replaces the nasty 
switch statement that would have been necessary if you had used 
some kind of brute force packet method. 

Bare of its error handling, SendObject () is a fairly simple algo¬ 
rithm also: 

BOOL CObjectSocket::SendObject( 

CNetObject * pNObj) 

{ 

if disconnected!)) 

return FALSE; 

*m_pArchiveOut « pNObj; 
m_pArchiveOut->Flush(); 
m_pArchiveOut->Clear Index!); 
return TRUE; 

1 

SendOb j ect () accepts a pointer to any CNetObject. The connection 
is tested to make sure it is still current. SendOb ject() next sends the 
CNetObject to the archive, then flushes the archive (otherwise it 
would never be sent). Finally, SendObjectO calls Cl earlndex() 
and returns TRUE. What you do with the object pointer after the 
function is called is strictly up to you, since it is no longer needed 
for transmission. 

Summary 

As promised earlier, I will now identify the limitations this scheme 
places on transmittable objects. If you are allowing objects to be trans¬ 
mitted and then destroyed before the next object is transmitted, you 
must ensure that no CNetObject contains references to objects that 


itself does not contain, create, and destroy. All objects must be self- 
contained! If you need a reference to an exterior object, handle this 
through a global variable or a stati c member that can be assigned 
independently on either side of the client/server equation. 

Using the power already in your MFC investment, you can write 
specialized Internet communication programs fairly easily. You will 
find that these classes will save you an enormous amount of difficult 
coding and will let you concentrate strictly on functionality. The 
electronic distribution of the code (see Table of Contents for avail¬ 
ability) contains a sample program (a simple network tic-tac-toe 
game with chat capabilities) that demonstrates how these classes 
work together. □ 


Figure 2: Clearing the CArchive object index 


void CSocketArchive::ClearIndex<){ 
if (IsStoringOH 

if (m_nMapCount > 1)( 

m_pStoreMap->RemoveAl 10; 
m_pStoreMap-> 

SetAt(NULL,(void*)(DW0RD)0); 
mjMapCount - 1; 

} 

} 

else! 

while (m_nHapCount > 1){ 
mjMapCount--; 

m_pLoadArray->ReuoveAt( mjMapCount); 
} 
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Generate Web and Client/Server Applications 


Oracle Designer/2000 



Generate Client/Server 
Applications 


Generate Web 
Applications 




Designer/2000™ enables you to define your application visually rather than writing thousands of lines of procedural code. 
Then, at the touch of a button, you can generate either a Web or a client/server application — or both. So you don’t have 
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For more information, call Oracle 1-800-633-0747, ext. 10537, or find us on the Web at http://www.oracle.com 


ORACLE 

Enabling the Information Age ™ 


© 1996 Oracle Corporation. All rights reserved. Oracle is a registered trademark, Oracle Designer/2000 and Enabling the Information Age are trademarks of Oracle Corporation. 

All other company and product names are the trademarks of their respective owners. 



























































































Gary S.Tessler, P.E. 


TrueGetVersion() for 16 -Bit Apps 

As versions of Windows (Windows 3.0, Windows 3.1, Windows 95, Windows NT 3.5, 
Windows NT 3.51, etc.) proliferate, detecting the current operating system version at run¬ 
time has become progressively more complicated. NT 4.0 introduces a new wrinkle by 
returning a false version of 3.10 to 16-bit programs that call GetVers i on() . This article 
describes the problem in detail and provides reusable code your 16-bit program can use to 
distinguish between different versions of Windows — even NT 4.0. 

Introduction 

If your programs are like mine, they work great under Windows 3.1 and Windows NT 
3.51, with the “Original GUI” that we’ve grown to love — or just got tired of hating. My 
programs usually do not need many of the new features of Windows 95 or NT 4.0 (such as 
multithreading and 3-D dialog box styles). By compiling my source code into a 32-bit pro¬ 
gram and adhering to other Microsoft Windows 95/NT logo requirements, I could use 
Microsoft’s logo on my product which would (according to Microsoft) impress users. But 
then I would have to ship multiple versions of my program — one distinct .exe for each 
operating system that the customer owns. This complicates testing, version control, order¬ 
ing, shipping, customer support, and increases customer confusion. 

I prefer to ship one version of my program that supports all currently shipping Microsoft 
operating systems. By correctly determining at runtime which operating system it is execut¬ 
ing under, my program can adjust its algorithms or behaviors (such as placing itself on the 
task tray or adding itself to the Start menu only if it is executing under the new user interface 
provided by Windows 95 and NT 4.0). 

It Used to Be Simple 

Before Microsoft released Windows NT 4.0, it was easy for a 16-bit program to deter¬ 
mine which operating system and version it was executing under (see Table 1). A call to the 
16-bit GetVers i on () would return the correct version when executing under Windows 3.1 
and Windows 95, but not under any version of Windows NT. To determine whether or not 
you are operating under Windows NT, you need a call to GetWi nFI ags (). GetWi nFI ags () 
can tell you if you are executing under Windows NT (the W F_W IN NT bit in its return value will 
be on), but it cannot tell you which version of Windows NT is running. 

It is interesting to note that a large number of Windows programmers incorrectly check 
GetVersi on ()’s minor version rather than checking both the minor and major version num¬ 
bers. For example, you might write code that required the minor version number to be 
greater than or equal to 10, so that you could safely take advantage of features that did not 
appear until Windows 3.10. To be able to execute as many of these existing 16-bit Windows 
3.1 programs as possible, Microsoft chose to have the Windows 95 GetVersionO lie to 
these programs by returning a version of 3.95 instead of 4.0. Thus, programs naively check¬ 
ing to see that the minor version was greater than 0 would be satisified, rather than aborting 
or incorrectly telling the user that a newer version of the operating system was required. 

Windows NT also lies to 16-bit programs for presumably the same reason —- to keep 16- 
bit programs that perform naive version checking from breaking. However, NT does not fol¬ 
low exactly the same scheme as Windows 95. Under NT 3.51, the 16-bit GetVersionO 
claims that the version is 3.1, but under NT 4.0 (the version with the new Windows 95 user 
interface), the 16-bit GetVersionO reports 3.1 again, not 3.95 as Windows 95 does. So 
although a simple call to GetVersi on () reveals whether or not your 16-bit program is run¬ 
ning under Windows 95, the 16-bit GetVersi on () does not help you distinguish between NT 
3.10 and NT 4.0. That’s an important distinction to make if your 16-bit program wants to 
take advantage of new user interface features (such as the task tray) when they are available. 

How can a 16-bit program determine the correct version for Windows NT? First, note 
that a 32-bit program running under NT does not have a problem, because the 32-bit version 
of GetVersi on () reports the correct version number (see Table 2). A 32-bit program that 
calls GetVersi on () under either Windows 95 or Windows NT 4.0 will detect a major version 
of 4 and a minor version of 0, and the upper two bits of the DWORD that GetVersi OP () returns 
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version of my program 
that supports all 
currently shipping 
Microsoft operating 
systems. By correctly 
determining at 
runtime which 
operating system it is 
executing under, my 
program can adjust its 
algorithms or 
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distinguish between NT and Windows 95. If a 16-bit program running 
under Windows NT could somehow call the 32-bit GetVersionO 
(rather than the 16-bit GetVersi on () furnished by NT’s compatibility 
layer), it could obtain the correct NT version number. 

Generic Thunking to the Rescue 

Microsoft created a generic thunk API that lets your 16-bit pro¬ 
grams call Win32 API functions. In addition, generic thunking is 
fully supported under both Windows 95 and Windows NT. Several 


Table 1 : GetVersionO results for 16-bit programs 

Operating 

System 

Returned 
major Version 

Returned 
minor Version 

Comments 

Window 3.1 

3 

10 

correct 

Windows 95 

3 

95 

true version is 4.0 

Windows NT 3.51 

3 

10 

incorrect 

Windows NT 4.0 

3 

10 

incorrect 


Table 2: GetVersionQ results for 32-bit programs 

Operating 

Under 

Returned 
major Version 

Returned 
minor Version 

bit 31 

bit 30 

Windows 95 

4 

0 

1 

1 

Windows NT 3.51 

3 

51 

0 

0 

Windows NT 4.0 

4 

0 

0 

0 


articles have already been written that discuss generic thunking, so I 
will focus only on the specific generic thunking function calls I 
need to call the Win32 version of GetVersi on (). 

Your 16-bit program can use generic thunking to call a Win32 
function in three steps. First, call LoadLi braryEx32W( ) to load the 
32-bit DLL containing the Win32 function you want to call. Second, 
call GetProcAddress32W( ) to obtain the address of the Win32 func¬ 
tion’s entry point. Finally, pass this function address and any other 
required parameters to Cal 1 Proc32W( ), which will call the target 
function for you and handle all the required translations between 
16-bit protected mode and 32-bit protected mode. 

Cal 1 Proc32W( ) is the only complicated generic thunk API 
function of the set I’ve mentioned. The fact that it uses the Pascal 
calling sequence and takes a variable number of arguments makes 
it difficult to call correctly from C. Fortunately, the Win32 func¬ 
tion I want to call (GetVersionO) takes no parameters, so 
Call Proc32W( ) can be called directly with no fuss in this case. For 
more information about this function, see “Test Drive Win32 from 
16-Bit Code Using the Windows NT WOW Layer and Generic 
Thunk” by James Finnegan, Microsoft Systems Journal, June 
1994. Like that article, the electronic distribution of the code (see 
Table of Contents for availability) contains a sample program with 
a wrapper function that makes it easier to call CaIIP roc32W () in 
more general cases. 

TrueGetVersion() 

I created a function call TrueGetVersion( ) that 16-bit programs 
can call to obtain the correct operating system version. The declara- 
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SuperMonitor 
for DOS, Windows 

The flexible and versatile solution for your serial data and protocol analysis, 
The continous graphic user interface for DOS and Windows* guarantees^ 
easy operation. SuperMonitor is very quickly attached to a serial data 
transmission and is a silent but watchful observer of the operation. 

You are now able to considerably reduce 
your development time and costs when 
setting up or monitoring a serial link by 
using SuperMonitor. 

SuperMonitor is able to execute not only 
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• flexible software solution 

• up to 115 KBit baud rate 

• parity: none, even, odd, mark, space 

• stop bits: 1,1.5,2 

• data bits: 5,6,7,8 

• time stamps with a precision of 10 ps 

• display of all modem lines 

• dynamic trigger function 

• extensive display, print and search functions 

• limited buffer only through the PC memory 

• data swap-out for long day and night runs 

• display modes: ASCII, Decimal, Hexadecimal 

• up to two simultaneously running measurements in Windows 

• IRQ0..IRQ15 and any port address 

• includes special adapter, cabel and 16bit serial board 


SuperMonitor for DOS only $398 
SuperMonitor for Windows only $498 
SuperMonitor for DOS+Windows only $768 
SuperMonitor for Windows Twin only $748 
SuperMonitor for DOS+Windows Twin only $998 

*Windows=Windows 3.x + Windows 95 
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RS232-Toolkit, SuperCom for 


ipe 

DOS, Windows, OS/2, NT, WIN 95 

for MS C/C++, Visual C++, Turbo/Borland C/C++, 

Turbo/Borland Pascal, Delphi, IBM C/C++, WATCOM C/C++ 

SuperCom is the development tool for exacting serial communication 
software. That means high data security and highest transmission speed. The 
SuperCom libraries are fast even in a multitasking operating system like 
Windows 3.x, NT, Windows 95 or OS/2. The same programming interface is 
used among different languages and operating systems. 

• Interrupt driven: transmission, reception, linestatus, • Language independent DLL (Windows, NT, WIN95, 

modem status. Up to 115,200 bps. OS/2) which can be used for simultaneous transfers 

• UARTS: 8250,16450,16550 FIFO, any port address, by applications. 

• Simultaneous COM_1 ,.COM_36 (and unlimited). • Multiserial board support (AST, ARNET, DigiBoard 

• Direct register programming'. Interrupt-Sharing. PC/X, HOSTESS, STARGATE). Reduces loading of 

• Flow control: RTS/CTS, DTR/DSR, XON/XOFF and CPU through support of intelligent DigiBoard PC/Xe, 

user defined. ANSI, TTY, VT52. PC/Xem, PC/Xi boards (up to 7 Boards/PC !!!). 

• Modem support, RS422/485 support. 

• Supports 286 DOS-Extender (e.g. PharLap, Borland) 

• NO ROYALTIES. No resident drivers'. Just link the LIB. 

• FREE technical support. FREE demo 

• Full source code (C or Pascal and optimized ASM). 

• SuperCom++ (C++ or Pascal OOP) included. 

• Protected Mode Interface (Windows) included. 


• Protocols: ASCII, XMODEM, XMODEM/CRC, 

YMODEM, YMODEM/BATCH, ZMODEM. 

• Timer, Ctrl-Break and Exception handling. 

• Multitasking support (Windows, NT, WIN95, OS/2) 

• User Event Routines under DOS and Windows. 

• Under Windows user can even post messages to 
the application using PostMessage. 

C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows, OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ combo pack for DOS+Windows+OS/2 only $799 
C/C++ combo pack for DOS+Windows+NT only $799 
C/C++ combo pack for DOS+Windows+OS/2+NT only $999 
’Under DOS and Windows. Windows=Windows 3.x + Windows 9516bit, 

NT=Windows NT + Windows 95 32bit 

VISA, MC, COD. 
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NEW!!! COMM-Enhancer for Windows 3.x 

Forget the Windows 3.x COMM API limitations. Use the COMM-Enhancer and extend 
your Windows 3.x COMM API based applications. Up to 40 channels (COM1...COM40!) 
and up to 115.200 bps. It uses SuperCom 3!!! 

Price $299 (together with any SuperCom combo supporting Windows 3.x $199!) 


ADONTEC Computer Systems Ltd 

Hoelderlinstr. 32 

D-75433 Maulbronn, Germany 

Phone: +49-7043-9000-20 
FAX: +49-7043-9000-21 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436, USA 

Phone:+1-707-887-3400 
FAX: +1-707-887-1015 


In Israel, call: 

Phone: +972-3-924-3555 
, FAX: +972-3-924-3132 

In Italy, call: 

Phone:+39-49-8713444 
FAX: +39-49-8713055 
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tions for this function are in getver.h (Listing 1) and getver.c 
(Listing 2). As getver.h shows, TrueGetVersion( ) takes four 
arguments, which I will describe in detail. 

dwVersion: the address of the DWORD in which 
TrueGetVersi on () will store the operating system version informa¬ 
tion, using the same minor/major-swapped format that Microsoft’s 
GetVersionO uses. 

MajorVersion: the address of the integer where TrueGetVersi on () 
will store the major version of the operating system. 

Mi norVersi on: the address of the integer where TrueGetVersi on () 
will store the minor version of the operating system. 

S LongOSName: the address of the character pointer where 
TrueGetVersion( ) will store a string representation of the current 
operating system. This name is great for displaying in your pro¬ 
gram’s Help-About dialog box. You can see the various strings used 
at the top of getver.c (Listing 2). 

TrueGetVersion( ) also returns an integer that identifies the 
operating system, using the constants in getver.h (Listing 1). 


Listing 1: getver.h - 

- Declarations for TrueGetVersionQ 

1 1 11 

1 " 
iii 

i //define OS IS WIN16 

l 

' ill 

1 u 

//define 0S_IS WIN95 

2 

I II 

: //define OSJSJINNT ORIG GUI 

3 

1 // 

: : //define OS IS WINNT NEW GUI 

4 

1 // 

I //define OS IS UNDEFINED 

0 

1II 



1 " 

■ 1 nt TrueGetVersion(DWORD ‘dwVersion, 

1 // 

int ‘MajorVersion, 

J // 

int ‘MinorVersion, 

! 11 

const char 

“sLongOSName); 

1 11 

| /* End of File */ 
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SftTree 2.0 

Tree Control for Windows 


From simple listbox with bitmaps to multi-line, 
multi-column, hierarchical data display, 
SftTree delivers! 
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5 

□ # HP LaserJet III PS 
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® Ready 

► 6 

H TREECTL.CPP 

Sample Program 

0 Printing 


► 7 

@ TREEX.RC 


0 Ready 


1*8 

El BONUS.DOC 

Additional document... 

0 Ready 

. 

a*. 

♦ 

9 

□ ^ HP LaserJet 4 

2nd Floor, Room 206 

10 

1 URGENT.DOC 

Most urgent output 

□ Not ready j 

... ...1- 
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• multiple columns 

• multiple text lines per item 

• drag & drop with auto-scrol! 

■ single/multiple selection 

■ single/multiple roots 

• editable item data 


• columns with titles/buttons 

• resizable columns 

■ selectable column alignment 

• sorting 
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Use the DLL version with C, C++ (MFC, OWL) and other DLL-call 
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Listing 2: getver.c — Implementation for 
TrueGetVersionf) 


(/include (windows.h> 

//include "getver.h" 

//define HINSTANCE32 DWORD 
//define HWND32 DWORD 
//define HFILE32 DWORD 

// MS Win32 generic thunk functions 

HINSTANCE32 (WINAPI *LoadL1braryEx32W) (LPSTR, HFILE32, DWORD); 

BOOL (WINAPI *FreeLibrary32W) (HINSTANCE32); 

FARPROC (WINAPI *GetProcAddress32W)(HINSTANCE32. LPCSTR); 
DWORD (WINAPI *Ca11Proc32W) (FARPROC, DWORD, DWORD); 

const char os_is_winl6[] - "Windows (16 bit)"; 

const char os_is_win95[] - "Windows 95"; 

const char os_is_winnt_orig_gui[] - "Windows NT (Orig GUI)”; 

const char os_is_winnt_new_gui[] - "Windows NT (New GUI)"; 

const char os_is_undefined[] - "Unknown"; 


1j * * * * Irk Irk *** * * ** *** * * ** * ** ** ** * *★ ** *** * ** ** ** *** ★ ** ** *** ** * ** **** 

// function determines what operating system we are operating 
// Only needs to call kernel32.dll if is Win NT 
II 

-just like combined/reversed 
retcode format of GetVersionO 


returns; 


O.S. 


j Major Minor 
dwVer Ver Ver ‘sLongOSName 


16bit app under Win-3.1 3.10 3 
16bit app under Win95 3.95 3 
16bit app under WinNT-3.51 3.51 3 
16bit app under WinNT-4.0 4.0 4 
undefined OS 00 

return code: 0S_!S_WIN16 


10 "Windows (16 bit)" 

95 "Windows 95" 

51 "Windows NT (Orig GUI)" 
0 "Windows NT (New GUI)" 

0 "Unknown" 

for Windows 3.0 - 3.11 



The “Point-aiid-Click” Setup Builder 
for Windows 95/NT & Windows 3.1 

Imagine creating professional installs for your software in only 
minutes. You can with Setup Factory 4.0! Simply add your files, 
customize the screens you want to display and click the “Build” 
button. Your files are compressed, your setup program is created and 
then everything is output to your disk set. Sound easy? It really is! 

GREAT NEW FEATURES 

Single file setup.exe • Selective install • Builds both 16 and 32 bit 
setups • Full featured uninstall • Great for CD-ROM • Edit registry 
and system files • Wizard type interface • Install files to any location 
• Create shortcut icons and groups • Much more! 

TRY IT OUT - RISK FREE! 

You can get a fully functional evaluation version from our web site 
or our BBS at (204) 661 -3044. Better yet, call us or your favorite 
software dealer to order the complete package. With its royalty-free 
license and value conscious price, you'll be saving a lot more than 
just your time! 



SOFTWARE V^DESIGN CORP 
Tndigo Kose Corporation, P.O. Box 2159, Winnipeg, MB, Canada R3C 3R5 

(800) 665-9668 • www.indigorose.mb.ca/indigo 
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How TrueGetVersion() Works 

TrueGetVer$ion( ) is a simple function. First, I call the 16-bit 
GetVersion () function and use it to check whether or not the cur¬ 
rent operating system is Windows 95 (if so, the major version will 
be 3 and the minor version will be 95). If the program is executing 
under Windows 95,1 return that version information. 

If the program is not executing under Windows 95, it must be 
executing under Windows NT or Windows 3.1, so I call 
GetWi nFI ags( ) to distinguish between the two. The result of 
GetWinFl ags( ) ANDed with 0x4000 will be non-zero if my program 
is executing under Windows NT or Windows 95, but not under 
Windows 3.x. If GetWinFlagsO indicates Windows 3.1, then 
GetVersion( )’s result was accurate, so TrueGetVersiont ) can use 
that information and return. 

If GetWi nFI ags () indicates Windows NT (the Windows 95 case 
was already handled), then TrueGetVersi on () must call the 32-bit 
GetVers i on () via generic thunking. I load kernel 32 .dll and 
obtain the entry point to the 32-bit version of GetVersi on (). Next, I 
use Cal 1 Proc32W( ) to call the 32-bit GetVersi on( ), saving the ver¬ 
sion information, releasing kernel32.dll, and then returning. 

Summary 

I created a simple Microsoft MFC AppWizard-generated pro¬ 
gram that demonstrates calling TrueGetVersion() and displays the 
results in a message box. The complete source code is available 
electronically (see the Table of Contents for availability). 

Writing a 16-bit program is still one of the simplest ways to sup¬ 


port all Windows platforms (including non-Intel platforms) with a 
single .exe. With the introduction of Windows NT 4.0, it is no 
longer possible for a 16-bit program to determine which operating 
system and version it is executing under without resorting to calling 
Win32 functions. By including a few additional lines of code, your 
16-bit program can call my function to easily determine at runtime 
which operating system features are available. □ 


Listing 2: getver.c — continued 


// 

OS IS WIN95 

for Windows 95: 

ver >- 3.95 

// 

OS IS WINNT ORIG GUI 

for Windows NT: 

ver <- 3.51 

// 

OS IS WINNT_NEW_GUI 

for Windows NT: 

ver >- 4.0 

// 

OS IS UNDEFINED 

can't load Win32 

api -can't 

// 


get version 


// 




// 





j j ****** *********************************** ****** ***************** 

int TrueGetVersion(DWORD *dwVersion, int *MajorVersion, 
int *MinorVersion, const char **sLong0SName) 

{ 

DWORD MyKernel32Lib; // our kernel32.cm ptr 
static FARPR0C MyTrueGetVersion32 - NULL; 

DWORD dwVersionl6BitAPI, dwVersion32BitAPI; 

// check out actual OS with winl6 api call 
// note: the winl6 api call is not valid for WinNT 
// in that it cant distinguish between different version 
// numbers, it returns 3.1 for both. So will need Win32 
// thunk 

dwVersionl6BitAPI - GetVersion(); 

if ( (L0BYTE(L0W0RD(dwVersionl6BitAPI)) >- 3) && 

(HIBYTE(L0W0RD(dwVersionl6BitAPI)) >- 95) ) { 

// is win 95 >- 3.95 
*dwVersion - dwVersionl6BitAPI; 

*MajorVersion - L0BYTE(L0W0RD(dwVersionl6BitAPI)); 

*MinorVersion - HIBYTE(L0W0RD(dwVersionl6BitAPI)); 
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10417200 
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32334.00 

37634.00 

34329.00 

104297.00 
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428728.00 

89638.00 

95649.00 

107203.00 
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13258900 
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Listing 2: getver.c — continued 


1 *sLongOSName - os_is_win95; 
return(0S_IS_WIN95); 

} else { 

// not win 95. must be NT or WIN 3.1 or unknown 
^define WF_WINNT 0x4000 // defined in Win32.h 

if ( (GetWinFlagsO & WFJINNT) ) { 

// WOW under NT. we need to call GetVersion 
// from Win32 api to determine correct 
// versions via thunking... 

f 

// need to load our dll to access our 32bit function 
MyKernel32Lib = LoadLibraryEx32W( "kernel32.dll", 

NULL, 0); 

if (!MyKernel32Lib) { 

*dwVersion - 0; 

*MajorVersion = 0; 

*MinorVersion = 0; 
return(OSJSJJNDEFINED); 

} else { 

// loaded dll ok 

// Attempt to get the address of the Win32 
// GetVersion 

MyTrueGetVersion32 = (FARPROC) GetProcAddress32W( 
MyKernel32Lib, "GetVersion"); 
if (!MyTrueGetVersion32) { 

*dwVersion = 0; 

*MajorVersion - 0; 

*MinorVersion = 0; 

*sLong0SName = os_is_undefined; 
FreeLibrary32W(MyKernel32Lib); 
retu rn(0S_IS_UNDEFI NED); 

} else { 

// got it so can call function 

} 

1 

// call our Win32 function via generic thunking 
// call by ref-1 or value-0, arg count 
// GetVersionO has no parameters.... 
dwVersion32BitAPI = (DWORD) Cal 1Proc32W( 


MyTrueGetVersion32, 0, 0); 
*dwVersion = dwVersion32BitAPI; 

*MajorVersion = L0BYTEC L0W0RD(dwVersion32BitAPI)); 

*MinorVersion - HI BYTE(L0W0RD(dwVersion32BitAPI)); 

if ((*MajorVersion <= 3) && (*MinorVersion <- 51)) { 

// is win NT old gui (ver <=3.51) 

' *sLong0SName - os_is_winnt_orig_gui; 

// clean up 

FreeLibrary32W(MyKernel 32Li b); 
return(0S_IS_WINNT_0RIG_GUI); 

) else { 

// see if new gui 

if ((*MajorVersion >- 4) && (*MinorVersion >- 0)) { 
// is win NT new gui (ver >- 4.0) 

*sLongOSName = os_is_winnt_new_gui; 

// clean up 

FreeLibrary32W(MyKernel32Lib); 
return(0S_IS_WINNT_NEW_GUI); 

} else { 

// bad NT O.S. 

*dwVersion = 0; 

*MajorVersion = 0; 

*MinorVersion = 0; 

*sLongOSName = os_is_undef i ned; 

// clean up 

FreeLibrary32W(MyKernel32Lib); 
return(0S_IS_UNDEFINED); 

} 

} 

) else { 

// we are win 3.0 - 3.1. No need to load Win32 dll since 
// 16 bit GetVersion(0 works fine in this OS 
*dwVersion = dwVersionl6BitAPI; 

*MajorVersion - L0BYTE(L0W0RD(dwVersionl6BitAPI)); 
*MinorVersion = HI BYTE(L0W0RD(dwVersionl6BitAPI)); 

*s LongOSName = os_is_winl6; 
return(0S_IS_WIN16); 


// End of File 
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COMM-DRV/LIB™ 

Professional Serial I/O Libraries & DLLs for 
Windows 3.x, Windows 95, NT, & MSDOS 


« Supports ALL languages, tools, or applications that can 
call the Windows API. 
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© Same API for Windows 3x, Windows 95, NT, & MS-DOS, 
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CodeWizard. The only software available to 
assist programmers in achieving effective C++ 
programming — automatically. No need for 
manual labor; no memorization of applied rules; 
no crash course in “C++ 101.” 


Code* Wizard 

Para Soft Corporation 



Call now for more information on how to obtain 
your copy of CodeWizard. 

ParaSoft Corporation, 2031 S. Myrtle Avenue, Monrovia, CA 91016 
Phone - (818) 305-0041, Fax- (818) 305-9048 
° Website - http://www.parasoft.com, Email - info@parasoft.com 
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Jean-Louis Leroy 


Mapping SEH Exceptions to 
Visual C++ Exceptions 

Windows NT and Windows 95 both support Structured Exception Handling (SEH), a 
mechanism for throwing and catching exceptions. As a feature of the operating system, SEH 
works with C (and potentially other languages), not just C++. The evolving ANSI C++ stan¬ 
dard also defines an exception mechanism, but Win32 SEH is not defined in terms of C++ 
exceptions. Hence, your C++ code must use Windows-specific constructs to interact with 
SEH exceptions. This article describes the problem and shows how you can map SEH 
exceptions onto standard C++ exceptions under Visual C++. 

Exceptions 

A key feature of C++ exceptions is that they guarantee that stack objects get destroyed 
properly (i.e., the appropriate destructor is called) when an exception is thrown. Consider the 
following code fragment that uses C++ exceptions: 

class error { }; 

void bar() 

{ 

vector v; 
throw errorO; 

} 

void foot) 

{ 

try { 
string s; 
bar(); 

} 

catch (error) 

{ 

warn() ; 

} 

} 



“The code in this 
article lets you isolate 
the non-standard 
aspects of SEH 
exceptions and handle 
them as C++ 
exceptions. The result 
can be cleaner and 
more portable code.” 


The block preceded by the try keyword is guarded against exceptions of class error. The 
catch block is an exception handler. If any code inside the try block (including any func¬ 
tions which that code calls) throws an exception of class error, then control transfers direct¬ 
ly to the statements in the catch block. In this code fragment, the try block happens to call 
a function (bar( )) that always throws an exception. The exception unwinds the stack, look¬ 
ing for a function that can handle an exception of type error. As the exception-handling 
code unwinds the stack, it calls the appropriate destructors. In this case, it first calls the 
destructor for V (a stack variable defined in bar( )), and then calls the destructor for S. Note 
that S has to get destroyed properly, since the exception is transfering control outside of the 
try block, which is the scope S was defined in. 

Stack unwinding makes C++ exceptions difficult to implement efficiently. The compiler 
must somehow keep track of local objects, including in functions that don’t even use try or 
catch. However, most compilers now support exception handling, with the notable excep¬ 
tion of Microsoft’s moribund 16-bit compiler. 

Win32 Structured Exception Handling 

Win32 has its own Structured Exception Handling mechanism it uses to deal with several 
error conditions in a robust and flexible manner. For example, if a program causes an access vio¬ 
lation, Windows generates an exception that the program can either handle or ignore. If the pro¬ 
gram ignores the exception, Windows simply displays a dialog box and terminates the program. 

A Win32 program can also explicitly generate an exception by calling the API function 

Rai seException (): Jean-Louis Leroy is a freelance consultant and author. 

He can be reached at 100611.1330@compuserve.com. 
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VOID RaiseException( 

DWORD ExceptionCode, 

DWORD Continuable, 

DWORD ArgCount, 

CONST DWORD *ArgArray); 

Excepti onCode identifies the exception. Values with bit 28 turned on 
are reserved to the operating system and represent errors like access 



ar'Port I/O 
a'DPRAM 
alnterrupts 





Hardware Control Lib/OCX 


Simple: No DDK development. Easily create and debug 
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Does your application edit source files, 
macros or scripts? 


SourceView™ 

Add a syntax-highlighting text editor to your application with 
the SourceView editor library. Easily customized for any 
syntax. Examples provided for C, BASIC, and HTML. 

www.tetradyne.com 

(408) 377-6367 FAX: (408) 377-6258 tetradyne@mindspring.com 


Tetradyne 

Software Inc. 


□ Request Reader Service #123 a 


violation, integer and floating-point errors, and the like. Conti nuabl e 
is a flag that indicates whether the exception is continuable. If the exe¬ 
cution is continuable, the handler can decide to “fix” the error condi¬ 
tion and allow the guarded code to resume execution as if nothing had 
happened. This feature has no equivalent in C++. The last two parame¬ 
ters can be used to transmit extra information along with the exception. 
They consist of a count and a pointer to an array of DWORDs. 

Figure 1 shows how to catch Windows-generated exceptions and 
raise user-defined exceptions. Visual C++ uses the vendor-specific 

keywords_try and_ except for SEH exceptions because they are 

not compatible with C++ exceptions. 

In addition, Win32 supports finalization blocks — blocks of 
code that execute regardless of whether the guarded block was exit¬ 
ed normally or an exception was raised. C++ offers no direct sup¬ 
port for this, but you can achieve a similar effect by creating an 
object on the stack whose destructor contains the “finalization” 
code. C++ exception semantics guarantee the destructor will get 
called whether or not any exception occurs. 

The Win32 exception facility operates at a somewhat lower level 
than most programming languages. It uses words and pointers to 
transmit information about the exception. This is only normal when 
you consider that the operating system must service applications 
and DLLs are written in different languages with different excep¬ 
tion semantics. The pervading usage of callback functions makes it 
common for an application’s stack to contain frames set up by two 
or more programming languages. For example, Windows may 
determine that a window needs repainting, and call the appropriate 
window procedure. While Windows may be written in C, the win¬ 
dow procedure can be written in almost any language (e.g., C++, 
Pascal, Ada), thanks to the magic of dynamic linking. The window 
procedure might call a third-party library written in yet another lan¬ 
guage to perform the repainting. As a result, the runtime stack con¬ 
tains frames constructed by code compiled in multiple languages. 


Listing 1: simple.cpp — How to translate SEH 
exceptions 


| f include (windows.h> 
j # include <eh.h> 

# include (float.h> 

J # include (iostream.h> 

| struct AccessViolation { }; 

j _se_translator_function Chain: 

| void Translatortunsigned int code, EXCEPTION_POINTERS* p) 

I 1 

if (code - EXCEPTION_ACCESS_VIOLATION) 
throw AccessViolationO; 

if (Chain) 

Chain(code. p); 

1 

j int mainO 

I { 

I _se_trans1ator_function Chain - _set_se_translator(Translator); 

i try { 

*(int*) 0 - 0; 

} 

catch (AccessViolation) 

( 

cout (( "caught AccessViolation" (( end!; 

) 

return 0; 

I 1 

i //End of File 
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Listing 2: transex.h — Declarations for universal 
exception translator 


| #1fndef Win32Exception_defined 
f #define Win32Exception_defi ned 

i class Win32Exception; 
l class AccessViolation; 

f class Breakpoint; 

I class DatatypeMisalignment: 

I class SingleStep; 

f class ArrayBoundsExceeded; 

j class MathException; 

class FItException; 

class FItDenormalOperand; 
class FltDivideByZero; 
class FltlnexactResult; 
class FltlnvalidOperation; 
class FltOverflow; 
class FltStackCheck; 
class FltUnderflow; 
class IntException; 

class IntDivideByZero; 
class IntOverflow; 
j class Privlnstruction; 

I class NoncontinuableException; 

f class Win32UserException; 

I struct _EXCEPTION_POINTERS; 

class Win32Exception 

J l 

public; 

virtual ~Win32Exception(>; 
enum 

{ 

tr_AccessViolation - 1 « 0, 
tr_Breakpoint — 1 « 1, 
tr_DatatypeMisalignment - 1 << 2, 
tr_SingleStep - 1 « 3, 
tr_ArrayBoundsExceeded - 1 « 4, 
tr_FltDenormalOperand = 1 « 5, 
tr_FltDivideByZero - 1 « 6, 
tr_FltlnexactResult - 1 « 7, 
tr_FltInvalidOperation - 1 « 8, 
tr_FltOverf 1 ow - 1 « 9, 
tr_FltStackCheck - 1 « 10, 
tr_FltUnderfl ow - 1 « 11, 
tr_FltException - 

tr_FltDenormal Operand | 
tr_FltDivideByZero | 
tr_FltlnexactResult | 
tr_Fltlnval idOperation | 
tr_FltOverflow | 
tr_FltStackCheck | 
tr_FltUnderfl ow, 
tr_IntDi vi deByZero - 1 « 12, 
tr_IntOverflow - 1 « 13, 
tr_IntException - 

tr_IntDivideByZero | 
tr_IntOverflow, 

tr_MathException - tr_FltException | tr_IntException, 
tr_Privlnstruction - 1 << 14, 
tr_NoncontinuableException - 1 « 15, 
trJJserException - 1 « 16, 
tr_All - Oxffffffff 
}; 


static void SetTranslatorO; 

static unsigned Translatefunsigned exceptions, 

unsigned mask - tr_All); 

static void TranslatorCunsigned code, _EXCEPTI0N_P0INTERS* p); 


private: 

static unsigned translated; 
static int installed; 

}; 


class AccessViolation 

class Breakpoint 

class DatatypeMisalignment 

class SingleStep 

class ArrayBoundsExceeded 

class MathException 


public Win32Exception { ) 
public Win32Exception { } 
public Win32Exception { } 
public Win32Exception { } 
public Win32Exception { } 
public Win32Exception { } 


class FItException : public MathException 


public: 
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Since SEH exceptions are different than C++ exceptions, the ques¬ 
tion arises of how to handle them in your C++ code. SEH exceptions 
don’t know anything about C++ semantics, so the SEH specification 
does not handle the problem of calling destructors for objects it pops 

off the stack. Should you bracket each Windows API call with a_t ry 

block to prevent Win32 exceptions from jumping over stack-based 
C++ objects? Is it safe to throw C++ exceptions across operating sys¬ 
tem contexts? To alleviate the problem, Microsoft decided to build 
C++ exceptions on top of Win32 exceptions. 

When the compiler sees the throw keyword, it inserts a call to a 
routine (_CxxThrowExcept i on( )) that calls RaiseExceptionf) with 
a code identifying a C++ exception and a pointer to a structure con¬ 
taining the address of the exception object and its type information. 
Conversely, Visual C++ implements C++ catch handlers as Win32 

_catch handlers. This ensures that C++ exceptions won’t bypass 

the Win32 handlers set by the operating system or by DLLs, and 
that Win32 exceptions will trigger the destructor of C++ objects 
along their way to the handler. 

This choice is not without drawbacks, though. The worst prob¬ 
lem is “catch-all” handlers. In C++, you can write code like this to 
catch any kind of exception: 

try { 

// do some stuff 
} 

catch (...) // ... means "any" 

{ 

// code to recover 
} 
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Listing 2: transex.h — continued 


FT tException(); 


j class FItDenormalOperand 
j class FltOivideByZero 
| class FltlnexactResult 
j class FItInvalidOperation 
| class FltOverflow 
; class FltStackCheck 
| class FltUnderflow 
| class IntException 
j class IntDivideByZero 
| class IntOverflow 
class Privlnstruction 
| class NoncontinuableException 


public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 
public 


FItException { } 

FItException { } 

FItException { } 

FItException { } 

FItException { } 

FItException { } 

FItException { } 
MathException { }; 
IntException { }; 
IntException { }; 
Win32Exception { } 
Win32Exception { } 


class Win32UserException : public Win32Exception 
{ 

public: 

Win32UserException(unsigned code) 

: code(code) { } 

unsigned GetExceptionCodeO const 
{ return code: } 

private: 

unsigned code: 

}; 

j #endif 


Listing 3: transex.cpp — Win32Exception 
implementation 


# include <windows.h> 

# include <eh.h> 

# include <f1 oat.h> 

# include "transex.h" 

static _se_translator_function next; 

void Win32Exception::SetTranslator() 

{ 

if (!installed) 

{ 

_se_translator_function next - 
_set_se_translator(Translator); 

installed - TRUE: 

} 

! ) 

! unsigned Win32Exception::Translate(unsigned ex, unsigned mask) 
{ 

unsigned prev - translated: 

translated - (translated & -mask) | (ex & mask); 

return prev; 

I ) 

Win32Exception::~Win32Exception() 

i ( 

} 

I void Win32Exception::Translator(unsigned code, 

_EXCEPTION_POINTERS* p) 

{ 

switch (code) // parse exception 

{ 

case EXCEPTION_ACCESS_VIOLATION: 

if (translated & tr_AccessViolation) 
throw AccessViolation(); 
break; 

case EXCEPTION_BREAKPOINT: 

if (translated & tr_Breakpoint) 
throw Breakpoint); 
break; 

case EXCEPTION_DATATYPE_MI$ALIGNMENT: 

if (translated & tr_DatatypeMisalignment) 
throw DatatypeMisalignment); 
break; 

case EXCEPTION_SINGLE_STEP: 

if (translated & tr_SingleStep) 
throw SingleStepO; 
break; 

case EXCEPTION_ARRAY_BOUNDS_EXCEEDED: 

if (translated & tr_ArrayBoundsExceeded) 
throw ArrayBoundsExceededO; 
break; 

case EXCEPTION_FLT_DENORMAL_OPERAND: 

if (translated & tr_FltDenormalOperand) 
throw FItDenormalOperand(); 
break; 

case EXCEPTION_FLT_DIVIDE_BY_ZERO: 

if (translated & tr_FltDivideByZero) 
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With Visual C++, a catch (...) handler traps all exceptions, 
regardless of whether they were generated by a C++ t h row or by the 
operating system. That means catch(...) will trap access viola¬ 
tions, attempts to execute privileged or illegal instructions, etc. If 
your program anticipated the situation and knows how to deal with 
it, this may be acceptable. Otherwise, it’s a bug, and therefore you 
don’t want the program to execute a few thousand more instructions 
and crash again. Unfortunately, this is exactly what will happen if 
you set a catch(...) handler. First, the stack-based objects will be 
destroyed, then the handler will be executed. All of this will happen 
after the initial problem, and may cause further crashes that will 
make it difficult to determine the cause of the bug. For this reason, 
you should avoid using catch(...) handlers in VC++ programs. 

Translation 

So far, it looks like the only way of catching Win32 exceptions 
with C++ handlers is the dreaded catch(...) handler. Does this 
mean you can’t tell a divide-by-zero fault from an access violation 
without reverting to low-level Win32 exception handling? 
Fortunately not. A program can set up a function that the Visual 


Listing 3: transex.cpp — continued 


throw FltDivideByZeroO; 
break; 

case EXCEPTION_FLT_INEXACT_RESULT: 

if (translated & tr_FltInexactResult) 
throw FltlnexactResultO; 
break; 

case EXCEPTION_FLT_INVALID_OPERATION: 

if (translated & tr_FltlnvalidOperation) 
throw FItlnvalidOperation(); 
break; 

case EXCEPTION_FLT_OVERFLOW: 

if (translated & tr_FltOverf1ow) 
throw FItOverflow(); 
break; 

case EXCEPTION_FLT_STACK_CHECK: 

if (translated & tr_FltStackCheck) 
throw FltStackCheckO; 
break; 

case EXCEPTION_FLT_UNDERFLOW: 

if (translated & tr_FltUnderflow) 
throw FItUnderf1ow(); 
break; 

case EXCEPTIONSNT_DIVIDE_BY_ZERO: 

if (translated & tr_IntDivideByZero) 
throw IntDivideByZeroO; 
break; 

case EXCEPTION_INT_0VERFL0W: 

if (translated & tr_IntOverflow) 
throw IntOverf1ow(); 
break; 

case EXCEPTION_PRIV_INSTRUCTION: 

if (translated & tr_PrivInstruction) 
throw PrivInstructionO; 
break; 

case EXCEPTION_NONCONTINUABLE_EXCEPTION: 

if (translated & tr_NoncontinuableException) 
throw NoncontinuableException(); 
break; 

default: 
if (next) 

next(code, p); // chain 
if (translated & trJJserException) 
throw Win32UserException(code); 

} 

if (next) 

next(code, p); // chain 


int Win32Exception::instal1ed; 
unsigned Win32Exception:translated; 

FItException::FItException() 

{ 

_clearfp(); // turn off exception for .controlfp to succeed 
unsigned cw - .controlfp(0, 0); // save current control word 
_fpreset(); // reset everything 
_controlfp(cw, unsigned(~0)); // restore control word 
} 

//End of File 


C++ runtime library will call when a Win32 exception occurs. This 
function can examine the information associated with the exception 
and then decide to throw a C++ exception — a process called 
exception translation. As a result of translation, the exception is 
typed (in the C++ sense), making it possible to catch a specific 
exception by specifying its type in the catch statement. It turns out 
that writing such a translator is not as easy as it seems at first sight, 
but it does pay off. Once it’s finished, you can stick it in a library 
and forget about Win32 SEH exceptions altogether. You won’t even 
need to include <wi ndows. h> or <eh. h> anymore! 

simple.cpp (Listing 1) demonstrates how to map an access viola¬ 
tion to a C++ exception, mai n () sets up a translator function and saves 
the address of the previous translator. It then triggers an access viola¬ 
tion. The runtime library takes over and calls Translator!), passing it 
the exception code and platform-dependent information. If the transla¬ 
tor recognizes the exception, it throws a C++ exception, and control is 
transferred to the appropriate handler in mai n (). The translator can, of 
course, chain to the previous translator in much the same way as signal 
functions or new handlers. If the translator returns normally (i.e., with¬ 
out throwing), the exception is considered “anonymous” and will only 
be caught by a catch (...) clause. 

Floating-Point Exceptions 

In my experience, math-related exceptions such as overflow 
and divide-by-zero are the best candidates for translation. There is 
controversy about whether or not such errors should throw excep¬ 
tions; in his book The Design and Evolution of C++, Bjame 
Stroustrup opposes it. However, there are cases where this approach 
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makes a lot of sense. For example, system¬ 
atically checking for possible overflow 
leads to programs that are both unreadable 
and inefficient. The FPU does a better job 
at checking overflows that anything you 
could write in straight C++ code. Another 
important case is legacy code, typically 
written in FORTRAN, inherited from the 
old days when a program encountering a 
math error was allowed to simply terminate 
with a cryptic message. This is unaccept¬ 
able in modern user-driven GUI applica¬ 
tions. Placing the FORTAN code in a DLL 


(so that its resources can be freed by 
unloading the library) and trapping math 
exceptions is often the best way to go. 

By default, VC++ disables floating¬ 
point exceptions. Operations such as 
divide-by-zero result in a special bit pattern 
representing either infinity or indetermina¬ 
cy. These special values will behave quite 
reasonably in regard to further operations. 
If you want the FPU to generate exceptions, 
you must first enable them by calling _Con- 
trolfpO. This function is portable across 
all Win32 platforms and also works on non- 


Intel processors. In addition to exceptions, 
it can be used to control the rounding, the 
precision, and the manner in which infinite 
values are handled. The function takes two 
parameters: the new control word value and 
a mask defining which bits of the control 
word are being changed. 

After an exception has occurred, you 
must not forget to clear it, otherwise all 
subsequent floating-point operations will 
trigger the exception again. You can’t sim¬ 
ply call _fpreset0, as suggested in the 
Microsoft help files, because it resets the 
control word as well, thus disabling further 
floating-point exceptions. It took me some 
time to devise the correct procedure: 

// clear exception (otherwise 
// _controlfp() will fail) 

_clearfp(); 

// save current control word 
unsigned cw = .controlfp(0, 0); 
_fpreset(); // reset fp stack 

// restore control word 
.controlfp(cw, unsigned(-O)); 

.clearfpO is needed to prevent further 
operations from throwing an exception, 
.control f p( ) returns the current value of 
the control word, and _f preset () empties 
the floating-point stack and sets the control 
word to default values. You can then use 
.control fp () again to restore the control 
word to its initial value. 

Hierarchy 

Now that you can map Win32 SEH- 
style exceptions to C++ exceptions, to what 
classes should you map them? There are 
several possibilities. You could use a single 
Wi n32Excepti on class with a member vari¬ 
able containing the exception code, and 
have the handler decide whether or not it 
wants to deal with the exception, probably 
by using a swi tch statement. Or, you could 
map each exception to its own class, but 
guarding a block against all floating-point 
related exceptions will lead to a prolifera¬ 
tion of handlers. 

Fortunately, C++ has a very elegant solu¬ 
tion to this problem: you can organize excep¬ 
tions in an inheritance hierarchy (see Figure 
2). With this approach, a program can set a 
handler for a specific exception; e.g., catch 
(FI tDi videByZero). It can also set a handler 
for all math-related exceptions with catch 
(MathException). The names I have chosen 
match those of the exception codes found in 
eh. h, except for the last one, which I use to 
map user-defined Win32 exceptions. 
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The Universal Translator 

My universal translater for SEH excep¬ 
tions consists of three functions and a set of 
constants, all of them in the 
Win32Exception base class. The declara¬ 
tions for the translator are in transex. h 
(Listing 2), while the implementation is in 
transex.cpp (Listing 3). 

Win32 Except ion::SetTra n s1ator() 
installs the translator; you can call this static 
function once at the beginning of your pro¬ 
gram. Win32Exception::Trans 1 ate() 
enables or disables the mapping of Win32 
exceptions to C++ exceptions. This is neces¬ 
sary because most programs will need to 
map only a subset of the possible Win32 
error conditions. It works like the standard 
i OS:: setf () function. Both of its parame¬ 
ters are bit masks representing one or many 
exceptions. The second parameter defines 
which exceptions are being enabled or dis¬ 
abled, depending on the value of the corre¬ 
sponding bit in the first parameter. Each class 
in the hierarchy above has an associated bit 
(for leaf classes) or bit set (for base classes) 
declared in the form tr_XXX, where XXX is the 
name of the class. In addition, tr_Al 1 repre¬ 


sents the entire hierarchy. These masks can. 
of course, be ORed together. 

The translator itself 

(Win32Exception::Transl ator ()) is 

straightforward. It uses a SWi tch statement to 
identify the exception code and throws the 
corresponding C++ exception if the related 
bit is set. Otherwise, the previous translator 
(if any) is called. If the exception cannot be 
identified (i.e., it is a user-defined exception 
triggered by Rai seException()), 
Wi n32Excepti on:: Transl ator () calls the 
previous translator. If it fails to map the 
exception, and translation of user exceptions 
is enabled, a Wi n32UserExcepti on is thrown. 

You may have noticed that I use the C++ 
keywords try/catch/throw instead of the 
MEC macros TRY/CATCH/THROW. There are 
two reasons for this. First, not all apps are 
MFC-based, and I wish to support those as 
well. Second, those macros are on the way 
out. They existed only because true C++ 
exceptions were not available in the early 
releases of MFC. They’re still absent from 
the 16-bit version of the compiler, but 16-bit 
apps don't get to use Structured Exception 
Handling anyway. More information on this 
subject is available from MFC Technote #32. 


Conclusion 

The new Win32 SEH mechanism is 
somewhat incompatible with standard C++ 
exceptions, but you may still have to deal 
with it. The code in this article lets you iso¬ 
late the non-standard aspects of SEH 
exceptions and handle them as C++ excep¬ 
tions. The result can be cleaner and more 
portable code. □ 


Figure 2: A possible Win32 
exception hierarchy 
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Tech Tips 



MFC Operator new Does Not Return NULL on Failure 

Dan Shappir 
shappir@math.tau.ac.il 

Like the standard C function mallocO, the C++ operator new 
returns NULL when it fails. You can make operator new throw an 
exception when heap space runs out using the standard 
set_new_handler() function declared in <new.h> (see Bjame 
Stroustrup’s book The C++ Programming Language 2nd edition, 
section 9.4.3 for details). Exceptions are the preferred mechanism 
for handling resource exhaustion, which is perhaps why MFC’s new 
operator throws an exception rather than returning NULL on failure. 
This is true not only for allocating objects derived from CObject, 
but for all uses of operators new and new[ ]. Therefore, when using 
MFC, the following check is useless: 

char* p = new char[1024]; 

ASSERTtp !- NULL): 

When MFC’s operator new fails because of heap space exhaus¬ 
tion, it calls AfxThrowMemoryException (), which throws a 
CMemoryException type object. If you don’t catch this exception 
yourself, MFC pops up a message box to notify you that memory 
has run out. If you want operator new to return NULL when it fails, 
you must use MFC’s version of the Set_neW_handl er () function, 
called AfxSetNewHandl er( ), whose prototype is given in <afx. h>. 
This function is not documented in the MSDN CD-ROM. The 
MFC documentation expressly forbids using set_new_handler( ) 
(which it sometimes calls _set_new_handl er( ) and sometimes 
_new_handler( )). Like set_new_handler( ), this function takes a 
single argument which specifies the function to be called when the 
heap is exhausted. AfxSetNewHandl er( ) also returns a pointer to 
the previous handler. The default handler is AfxNewHandl er( ) 
which calls AfxThrowMemoryException(). AfxSetNewHandler( ) 
has the following properties: 

1. Calling AfxSetNewHandl er () with a NULL argument causes 
operators new and operator new[] to return NULL on failure. 

2. Unlike a handler set by set_new_handl er( ), the handler set 
by AfxSetNewHandl er( ) can return 0, thus instructing operator new 


mrn| Can't find that Tech Tip from a past issue? The Windows Developer's 
LLIS Journal CD-ROM with full search capabilities is now available. 

Ual See page 16 for more information. 


Leor Zolman teaches hands-on seminars on C/C++ programming and UNIX. 
His first book, Illustrated C, was published in 1992. Contact Leor at the 
leor@bdsoft.com, or visit the BD Software On-Site Training page at 
www.tiac.net/users/leor/bds for information about his C and C++ seminar offerings. 


to fail and return NULL. The return of a non-zero value instructs 
operator new to try again. 

3. AfxSetNewHandl er () works on a per-thread basis. Setting an 
alternative handler doesn’t effect the other threads in the process. 
Newly spawned threads, however, inherit the handler of their parent 
thread. MFC also supplies AfxGetNewHandler( ), which is also 
undocumented in the MSDN. AfxGetNewHandl er( ) returns the cur¬ 
rent handler without setting a new one. 

Using Structured Storage forTreeview Drag and Drop 
between Different Processes 

Dzhangir “Jim” Dadashev 
102520.1241 @compuserve.com 

Implementing drag and drop functionality between different 
applications requires providing the tree structure that can be used 
across the process boundaries. In other words, to keep a tree struc¬ 
ture, you must somehow serialize HTREEITEM handles. I find it con¬ 
venient to use structured storage for easy-to-use hierarchical infor¬ 
mation storage. 

The sample application TechTi p. exe (on the electronic distribu¬ 
tion as dragdrop.zip) has a splitter window with two panes. The 
left pane includes a CTechT i pVi ew, which is derived from 
CTreeView. The right pane includes is a CVi ew-derived window, 
which is not important for our topic. 

In the function CTechTi pVi ew: :OnBegindrag( ), I define the 
part of the tree (branch) that will be dragged. Then, using the func¬ 
tion copyTreeBranch ( ), I serialize that branch in the compound file 
storage object. The function copyTreeBranch( ) creates a com¬ 
pound file storage object based on the global memory block. 

There are two types of tree items: Groups (which have children) 
and Leafs (which don’t). For every Group, I create two objects: a 
Substorage object with the Group name and a Stream object with 
the Group data. For every Leaf, I create one Stream object with the 
object’s name and data. This is implemented through recursive calls 
to the function serial izeTree (), which serializes the whole tree. 
Function serial izeTreet ) calls function serial izeltem( ) which 
creates the Stream object and (through the call to 
seri al i zeTVItemC )) saves the contents of TV_ITEM elements into 
the Stream. If I serialize a Group object, seri al i zeltem( ) creates a 
Substorage object and returns a pointer to it. On the target side, in 
the function CTechTipView: :0nDrop( ), I can read data from the 
storage object with the readTreeBranch( ) function. This function 
recursively goes through the Storage and rebuilds the tree. 

The sample application was built with the Application Wizard as 
both an OLE container and server that supports OLE Automation 
and OCXs. 

The following files and functions were modified: 
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MainFrm.cpp. Function OnCreateCl ient( ) — creates a static split¬ 
ter with two columns and one row. 

TechTipView2.cpp. The implementation file for the CTechT i pV i ew2 
class, which is not important for this discussion. 

TechTip.cpp. Function createlmages () —creates an image list and 
registers clipboard format for future drag and drop operations. 
TechTi pVi ew. cpp. The following member elements were added: 
HTREEITEM m_DragSourceItem — indicates the HTREEITEM 
where drag was started. Used for drag-and-drop inside the appli¬ 
cation address space. 

I Storage* m_p I Storage — a pointer to the global storage object. 
HGLOBAL m_hGl obal — a handle to the global memory, which is 
the media for the Storage object. 

C01 eDropTarget m_dropTarget — see the MFC documentation. 
The following functions were added: 

OnBegindragO — initiates drag and drop operation, creates a 
Storage object, and copies data into the Storage. 

OnDragEnter ( ), OnDragLeave( ) , OnDragOverO — seethe 
MFC documentation. 

On Drop () - reads data from Storage, rebuilds the tree. 
copyT reeBranch (), serializeTreeO, serial izeltemO, 
readT reeBranchl), serializeTVItemO, addT reeNode () 

discussed previously. 

OnCreatet ) — creates a sample tree. 

addT reel tem( ) — used to fill the tree with data. 




SDK Annotation #159 


TYPE: MFC 4.x 

TOPIC: CFontDialog::GetCurrentFont 
KEYWORD: CFontDialog::GetCurrentFont 

Though the documentation mentions that you 
can call this function after calling DoModal, the 
function incorrectly ASSERTS that its window 
handle is not NULL. 




Instead, use the public CFontDialog member 
variable mjf. 

Submitted by Tim Lesher. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 



Dragging Captionless Windows: Another Look 

I. H.Ting 

100023.3363@compuserve.com 

While reading your “Tech Tips” column in the latest Windows 
Developers Journal, I realized that one of the tips looked very much 
like a little function I wrote to drag and size windows. I used the 
function in Figure 1 to manipulate subclassed Windows controls in 
a GUI design environment I was developing. 

Perhaps you could make it available to your readers? 

Make it so. — lz 

Custom Captions 

Muthuvale Shanmugam 
103624.1501 @ compuserve.com 

While implementing certain screens, I have often felt that the 
standard caption bar provided by Windows was not appropriate. For 
a small status window that is hardly 50 pixels high, a 5-pixel caption 
bar may be more appropriate than the standard caption bar. For a 
palette window (displaying a list of icons for users to select) that 
needs to be moved frequently, a caption bar on all four sides may be 
more appropriate than a caption bar on top. For a screen replicating a 
real-world paper form with a triangular title on the right top of the 
paper, a triangular caption on the right top comer of the window may 
be more appropriate than the standard caption bar (see Figure 2). 

Though Windows provides only one type of caption, implement¬ 
ing the above mentioned types and various other types of captions is 
not difficult. To implement a custom caption, you must first make it 
look like one, and second make it work like one (i.e., the user should 
be able to move the window around by dragging the caption). 


Figure 1: Funtion to drag a captionless window 


/* 

* Call this function on WM_NCHITTEST with the 

* window handle and cursor position 
*/ 

U1NT WinSizeDragCHWND hwnd, int x, int y) 

{ 

UINT uHitCode; 

RECT rect; 

int nBorderWidth-GetSystemMetrics(SM_CXFRAME); 
GetWindowRectlhwnd, &rect); 
if(abs(x-rect.left)<-nBorderWidth){ 
if(abs(y-rect.top X-nBorderWidth) 
uHi tCode—HTTOPLEFT: 

else if(abs(y-rect.bottom)<—nBorderWidth) 
uHitCode—HTBOTTOMLEFT; 
else 

uHitCode—HTLEFT; 

1 

else if(abs(x-rect.rightX-nBorderWidth){ 
if(abs(y-rect.top)<—nBorderWidth) 
uHitCode—HTTOPRIGHT; 

else if (abs(y-rect. bottomX—nBorderWi dth) 
uHitCode—HTBOTTOMRIGHT; 
else 

uHitCode—HTRIGHT; 

1 

else if(abs(y-rect.top)<—nBorderWidth) 
uHitCode-HTTOP; 

else if(abs(y-rect.bottom)<—nBorderWidth) 
uHi tCode—HTBOTTOM; 
else 

uHitCode—HTCAPTION; 
return uHitCode; 


42 


• windows developer’s journal • www.wdj.com • 


January 1997 














Making the caption look like a custom caption is easy. You can 
create a window without a caption bar, then during the WM_PAINT 
message, you can paint the custom caption in your client area. 

Making the caption work like a custom caption is a bit trickier. 
To illustrate why, I will briefly review Windows mouse message 
processing. Whenever a mouse event occurs on an application win¬ 
dow, Windows System sends a WM_NCH ITTEST message to the appli¬ 
cation window. In response to this message, the application window 
should return a value that indicates the location of the cursor, which 
can be HTCLIENT, HTCAPTION, HTBORDER, etc. Windows needs this 
return value for subsequent processing. Normally, an application 
will not answer this WM_NCHITTEST message — it will let its 
DefWi ndowProct ) answer it. 

If the window has a custom caption on 
the client area, and the user clicks on that 
caption (which is actually the client area), 

Windows will send a WM_NCHITEST message 
to the application. In response to this 
WM_NCHITEST message, DefWindowProc() 
will answer with the return value 
HTCLIENT (because the cursor is in client 
area). Here’s the trick: instead of letting 
DefWindowProct ) respond to WM_NCHITEST 
when the cursor is in the custom caption, 
you can trap WM_NCHITEST and answer with 
the return value HTCAPTION instead of 
HTCLIENT. This will bring your custom cap¬ 
tion to life (see SDK Annotation #8). 

The implementation of the custom cap¬ 
tion bars is in the sample application 
capt.zip, which contains capt.c and 
capt.def. capt.zip is available electroni¬ 
cally (see Table of Contents for availability). 

If the window is created with 
WS_MAXIMIZEBOX style, then double click¬ 
ing on your custom caption bar toggles 
the window between maximized mode 
and restored mode, as does double click¬ 
ing on the regular caption bar. Small 
fonts, bitmaps, and italicized fonts (for 
triangular caption) can be used to fill the 
caption. You could also choose to leave 
the caption blank. If a system menu is 
required, paint the appropriately sized 
system menu icon on the caption bar and 
use TrackPopupMenut ) to display the 
menu. Returning HTSYSMENU for the 
WM_NCHITTEST message may not help, 
because while being drawn, Windows 
System menus assume the caption bar 
thickness to be of standard size. □ 




Figure 2: Sample Custom Captions 
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Eric Heimburg 


Improving theTreeview Control 

Windows 95 introduced a new treeview control that attempts to solve the common prob¬ 
lem of displaying tree-like structures in a listbox-like control. You can learn how to create 
and populate a treeview control from the SDK documentation that comes with your compil¬ 
er, but once you get beyond the basics, you may run into trouble. This article offers several 
ways of improving the treeview’s basic drag-and-drop support. I also discuss the new ver¬ 
sion of the treeview control, including some features not documented elsewhere. 

Basic Treeview Drag-and-Drop 

One of the most useful features of the treeview control, drag-and-drop, is difficult to mas¬ 
ter because it is poorly documented. In fact, the sample code in the Win32 SDK’s treeview 
overview is more confusing than helpful: the snippets of code presented there are full of 
unused variables, the comments are misleading, and critical function calls (such as 
Image Li st_DragEnter ( )) are omitted. My copy of the SDK doesn’t include any sample pro¬ 
grams that use treeview drag-and-drop, either. Fortunately, implementing drag-and-drop 
with the treeview is very similar to implementing drag-and-drop with the listview (there are 
corresponding treeview messages for each of the listview drag-and-drop messages). If 
you’ve figured out the listview’s API, you’ll have few problems implementing the basics of 
treeview drag-and-drop. (For an implementation of listview drag-and-drop using MFC, see 
“Drag-and-Drop Support for MFC Listviews” by V. Ramachandran in the May 1996 
Windows Developer’s Journal.) The only major difference between the two controls is in 
how they implement “drop highlight” (explained in the next section). 

You handle most of the work of implementing basic drag-and-drop when you receive a 
TVN_BEGINDRAG notification, which arrives as a WM_N0TI FY message. Here are the steps you 
need to take at that point: 

1. Call ImageLi st_Begi nDrag(). 

2. Create the image to be used during the drag-and-drop operation. The easiest way to do 
this is by calling TreeVi ew_CreateDragImage( ), which returns a temporary ImageLi st 
containing the picture to be used during dragging. 

3. Set the focus to the treeview with SetCapture( ). (Like the listview, the treeview doesn’t 
automatically set the focus when clicked on, so you must do this yourself if you want the 
treeview to receive keystrokes such as the Escape key.) 

4. Capture mouse input with SetCapture( ) so that your window will receive all future 
mouse messages until the mouse button is released. 

5. Hide the current mouse cursor by calling ShowCursor ( FALSE) . 

6. Call ImageLi st_DragEnter( ), specifying the window that will contain the mouse cursor; 
during the drag-and-drop operation, the mouse cursor will be visible only while it is posi¬ 
tioned over this window. You also pass ImageLi St_DragEnter( ) a POINT structure, indi¬ 
cating the initial position of the cursor. The coordinates are relative to the upper-left of the 
window’s nonclient area, not the client area. 

These six steps start the drag-and-drop operation, with the mouse cursor changed to 
whatever cursor you specified to symbolize that a drag operation is taking place. You will 
probably also want to set a variable in your code to indicate that you’ve entered drag mode, 
since your WM_M0USEM0VE handler must call ImageLi st_DragMove( ) whenever you are in 
drag mode. As with ImageLi st_DragEnter, you pass ImageLi st_DragMove( ) a point whose 
coordinates are relative to the nonclient area of the window. 

Finally, end the drag operation in response to WM_LBUTTONUP (assuming the message 
arrives while you are in drag mode) by calling ImageLi st_EndDrag( ), which restores the 
previous mouse cursor and releases the mouse capture. 

ImageLi st_DragEnter( ) and ImageLi st_DragMove( ) require coordinates relative to the 
window’s nonclient area. There is no API function that obtains this information directly. The 
SDK overview for the imagelist control suggests that you determine the size of each of the 
nonclient area’s components (the menu, border, etc.), then subtract each from the window’s 
client rectangle. This method is very error-prone and cannot handle special circumstances, 
such as when a window’s menu contains multiple rows of items. Instead, most programs just 
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implementing 
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drag-and-drop.” 


H Borland C++ V5.01 
Visual C++ v4.1 


Eric Heimburg is a student at the University of 
Central Florida, and is employed by a contractor 
group that develops Windows-based training sys¬ 
tems for the U.S. Navy. He can be contacted via 
email at heimburg@cs.ucf.edu. 
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pass the desktop window’s handle to ImageLi st_DragEnter( ). This 
removes the nonclient-area problem because the desktop window 
has no nonclient area. Also, since the bounds of the drag-and-drop 
cursor are determined by the window handle you pass to 
ImageList_DragEnter( ), passing the desktop window handle lets 
the drag-cursor move anywhere on the screen. The only down side 
of this method is that your program is responsible for changing the 
drag-cursor image when the cursor isn’t over a valid drop-target. If 
your program allows the user to drop items into other programs, you 
should consider using the OLE drag-and-drop interfaces. They can 
determine which targets can accept your data and help you perform 
other bookkeeping. 

For simpler drag-and-drop tasks, such as allowing the user to 
drag items from one treeview to another treeview in the same appli¬ 
cation, passing the desktop window to ImageLi st_DragEnter() 
may be overkill. Instead, you could pass it the handle of the applica¬ 
tion’s main window, so that the drag-image is automatically bound- 


Figure 1: Coordinate conversion for treeview points 


/* function to convert coordinates relative to hWnd's client 
into coordinates relative to hWnd’s non-client area. */ 

void ClientToWindowtHWND hWnd. POINT *Pt) 

{ 

RECT WindowRect, Cl 1entRect; 

GetWindowRect(hWnd, &WindowRect); 

GetClientRect(hWnd. &C1ientRect): 

MapWindowPointsthWnd.HWND_DESKTOP,(LPPOINT)&C1ientRect,2); 
Pt->x — (WindowRect. 1 eft - ClientRect.1 eft); 

Pt->y — (WindowRect.top - ClientRect.top): 

1 
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ed by the main window’s borders. If you take this approach, you 
must once again consider how to make the cursor position relative 
to your nonclient area. Don’t follow the SDK’s suggestion and sub¬ 
tract each nonclient component by hand; instead, use a conversion 
function like the one in Figure 1. This function converts a POINT 
containing client coordinates (such as those received from 
WM_MOUSEMOVE) into a POINT relative to the nonclient area. It deter¬ 
mines the size of the nonclient area by getting the screen-coordi¬ 
nates of the window and converting them to client coordinates. 

Supporting the Drop Highlight 

The major difference between treeview drag-and-drop and listview 
drag-and-drop is in how the controls support the “drop highlight.” The 
drop highlight is just a normal highlight drawn on the item beneath the 
cursor. As the user drags the mouse over items in the treeview, the item 
under the cursor should be redrawn with the drop highlight appear¬ 
ance, providing a visual cue about where the dragged item will land if 
the user releases the mouse button at that point. If your application’s 
treeview control was the source of the drag-and-drop, your application 
must update the drop highlight when it moves the drag-and-drop cur¬ 
sor in response to WM_MOUSEMOVE messages. Updating the drop high¬ 
light is a bit tricky because ImageLi st_DragEnter () actually calls 
LockWi ndow(Jpdate( ) to suspend drawing in the window until the 
drag-and-drop operation is complete. This results in “artifacts” 
being left behind as the cursor moves. There are several ways to 
overcome this difficulty, but the simplest is to call 
ImageLi st_DragShowNol ock( ) before changing the drop highlight. 
This function temporarily releases the “lock” and hides the drag-cur¬ 
sor, allowing the area under the cursor to be redrawn. To re-show the 
drag cursor, call ImageLi st_DragShowNol ock( ) again with the second 
parameter set to TRUE. 

For some uses of drag-and-drop, the drop highlight feature isn’t 
appropriate. If you don’t allow the user to drop treeview items onto 
other treeview items, implementing the highlighting of items when the 
user drags something across them will only be confusing. You must 
always deal with the drop highlight in some way, though, even if it 
isn’t appropriate for your program, because before the treeview control 
sends TVN_BEG INDRAG, it applies the drop highlight to the item beneath 
the mouse cursor. If you do not wish to support the “drop highlight” 
feature, you should turn off the highlight for the item being dragged 
(by calling TreeView_SelectDropTarget( ) with an hltem of NULL) at 
the beginning of your TVN_BEGI NDRAG handler (before beginning drag- 
and-drop). Then call UpdateWi ndow( ) to force the treeview control to 
redraw the item immediately. If you do not call UpdateWi ndow( ), the 
item will be drawn when the drag-and-drop item is on the screen, and 
because of the “lock” described above, some or all of the item won’t 
be redrawn. 

Auto-Scroli During Drag-and-Drop 

If your program lets the user drag treeview items around in the 
same treeview, you need to add automatic scrolling support to your 
drag-and-drop implementation. When the user drags the mouse above 
or below the treeview’s client area during drag-and-drop, the window 
should scroll in that direction. If you do not support scrolling during 
drag-and-drop, and you have more items than can fit on the screen at 
once, some drag-and-drop operations will be impossible. For instance, 
the user won’t be able to drag the topmost item down to the bottom of 
the list. If dragging the item outside of the treeview has another mean¬ 
ing (such as if there is another drag-and-drop receptacle above this 
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treeview), you can scroll the window when the mouse is on the first 
or last visible item in the list, as does the Win95 Explorer. 

To implement auto-scrolling, create a timer when beginning the 
drag-and-drop operation. In your WM_TIMER handler, use TVM_HITTE$T 
to see if the item is outside of the client area; if it is, scroll the window 
in the appropriate direction. The actual scrolling requires several mes¬ 
sages. First, use TreeVi ew_GetFi rstVisiblef ) to locate the topmost 
visible item. Then, call TreeVi ew_GetNextItem( ) with a flag of 
TVGNJEXTVISIBLE or TVGN.PREVIOUSV I S I BLE (depending on which 
direction you want to scroll) to determine the new item to place at the 
top of the window, and use TreeVi ew_Sel ectSetFi rstVi sibl e( ) to 
designate this item as the topmost item. This effectively scrolls the 
window up or down by one item. 

Note that the TreeVi ew_Get Next I tem () documentation is mis¬ 
leading: it says that using the TVGN_N EXTV ISIBLE flag returns the 
next visible item, and that using TVGN_PRE V IOUSVISIBLE returns the 
previous visible item. Actually, the item that 
T reeVi ew_GetNextItem( ) returns might not be visible in the client 
area — it is the next (or previous) “expanded” item; that is, 
TreeVi ew_GetNext I tem( ) skips over items that can’t be seen 
because their parent items are collapsed. 

Scrolling Non-Drag-and-Drop Treeviews 

When you click on an item in a listbox or combobox and move 
the mouse without releasing the mouse button, the control high¬ 
lights the item under the mouse cursor; or, if the cursor leaves the 
control’s window, it scrolls the list of items up or down. In contrast, 
when you click and drag on an item in a non-drag-and-drop tree- 
view control, nothing happens. This isn’t very intuitive, and should 
be changed to behave like the listbox. A good example of a treeview 
that behaves this way is the Message window in Borland C/C++ 5’s 
IDE. (Borland’s control, by the way, is not based on the treeview 
common control; it’s been written from scratch. However, it still 
provides a good example of the behavior I’m after.) 

You can implement auto-scrolling for non-drag-and-drop treeviews 
in much the same way as for drag-and-drop treeviews. In fact, you can 
use the same notification, TVN_BEGI NDRAG, to decide when to begin 
auto-scrolling. In order to receive this message, you must not use the 
TVS_D ISABLEDRAGDROP style, because using this style suppresses 
TVN_BEGI NDRAG notifications. (Incidentally, TVS_D I SABLEDRAGDROP 
suppresses drag-and-drop only with the left mouse button — if the 
user drags with the right mouse button, the treeview control still sends 
the TVN_BEGINRDRAG notification!) 

Another reason not to use TVS_D I SAB LEDRAGDROP is that it sub¬ 
tly affects how TVS_EDITLABELS (the flag that lets users edit indi¬ 
vidual treeview item labels) behaves. Normally, when you use 
TVS_EDITLABELS, the user must press and release the mouse but¬ 
ton over the selected item to begin editing it. However, if the 
TVS_D I SABLEDRAGDROP bit is also on, the user need only press the 
mouse button over the currently selected item to begin editing — the 
edit box appears before the user releases the left mouse button. This is 
not desirable; if the user clicks on the currently selected item and starts 
dragging, it will be confusing if an edit box appears in place of the 
item being dragged! 

In response to TVN_BEGI NDRAG, set the focus to the treeview con¬ 
trol, capture the mouse input, and begin a timer—just as you would 
for scrolling drag-and-drop — but don’t issue any visual com¬ 
mands. In your WM_TIMER handler, call TVM_HITTEST, and if the cur¬ 
sor is over a new item, call TreeVi ew_Sel ect I tem () to change the 


normal selection (not the drag-selection!) to this item. If the user 
drags the mouse outside of the client area, scroll the window by 
sending WM_KEYDOWN and WM_KEYUP messages to simulate the press¬ 
ing of an arrow key. This scrolls the list by one item and changes the 
selection at the same time. 

Drag-and-Drop Considerations 

There are some special cases you need to consider when imple¬ 
menting drag-and-drop or when autoscrolling in a non-drag-and- 
drop treeview. One such case is when the user presses Alt-Tab in the 
middle of a drag-and-drop operation. When this happens, the oper¬ 
ating system automatically takes the mouse capture away from your 
program. Thus, when the user releases the left mouse button, your 
program won’t be notified; when the user returns to your applica¬ 
tion, the application still thinks the user is dragging and dropping. 

You can overcome this problem by handling 
WM_CAPTURECHANGED. Windows sends this message to a window 
whenever it is losing the mouse capture. When your window 
receives this message during the middle of drag-and-drop, it should 
cancel the operation. Be careful how you code the handler for this 
message; the message is sent regardless of how the focus was lost 
(even if you called Rel easeCapture ()). So, in this message’s han¬ 
dler, make sure that you are still in the middle of drag-and-drop. 

You also need to consider what to do when the user presses other 
keys while dragging. Microsoft Explorer ignores keystrokes while 
dragging. BC5’s treeview-like control accepts keyboard input so 
that if the user is dragging the item to another location in the con¬ 
trol, and discovers that the item is not visible because the parent is 
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“collapsed,” the user can expand the tree 
immediately. Under Explorer, this scenario 
forces users to cancel their drag operation, 
expand the tree so that their target is visi¬ 
ble, and then begin the drag-and-drop oper¬ 
ation all over again. 

The downside of allowing all keyboard 
input while dragging is that it can introduce 
subtle bugs. In BC5’s Message window, for 
instance, you can use the keyboard to open 
and close branches, but you can also press 
Enter to open the window associated with 
the current item. If you are scrolling the 


Message window, and you press Enter 
while the mouse cursor is above or below 
the Message window, a new Edit window 
appears as expected, but the Message win¬ 
dow keeps scrolling, never realizing that 
the user has finished the drag-and-drop 
operation. You have to close the Message 
window and re-open it to stop this behavior. 

Remember that the treeview control still 
receives TV N_KE Y DOWN messages during 
drag-and-drop, so the code that handles this 
message must allow only appropriate keys. 
One key that you definitely should handle 


is the Escape key to cancel the drag-and- 
drop operation. Programs that don’t sup¬ 
port this convention (such as BC5) can be 
very frustrating to users. 

In a dialog box, the message for the 
Escape key isn’t normally sent to the tree- 
view; the dialog window itself intercepts the 
message and ends the dialog. In order to 
receive the Escape key notification in your 
treeview, catch WM_GETDLGCODE. If you 
receive this message during drag-and-drop, 
return DLGC_WANTALLKEYS. (If it is received 
at any other time, return the default value; 
this lets the dialog process the Escape key 
when the user isn’t performing drag-and- 
drop.) Then catch WM_CHAR, and if it indi¬ 
cates VK_ESCAPE was pressed, end the drag- 
and-drop operation. For a more elegant 
solution to the Escape key problem, see V. 
Ramachandran’s article (referred to earlier). 

Due to a bug in the treeview control 
(documented in Knowledge Base article 
PSS # Q130691), the edit box that the tree- 
view control uses to edit labels in a tree- 
view has similar problems with the Escape 
key (and the Enter key): pressing Escape or 
Enter when editing a treeview label in a 
dialog will end the entire dialog instead of 
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presents Bug # 1402 

#include <iostream.h> 

class C 

{ public: 
int n, m; 

C( int nl, int ml ) 

{ 

n = nl > ml ? nl : ml; 
m = n < m ? nl : ml; 

> 

C( int nl = 0 ) 

{ n = nl > 0 ? nl : 0; m = 0; } 

>- 

main() 

i 

C x( 2, -2 ); 

cout << x.n << ' ' << x.m; 
return 0; 

> 

With one compiler the output printed is “2 -2 ” as expected, however with another 
compiler the output is “2 2". Why? Call if you need a hint, or refer to our web page 

at http: //www. gimpel. com. 

PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 
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scrutiny, checking for unparenthesized 
parameters, unparenthesized bodies and 
repeated arguments having side-effects. 

Plus Our Traditional C/C++ Warnings: 

Uninitialized variables, inherited non-virtual 
destructors, strong type mismatches, 
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and templates. It supports both Borland and 
Microsoft C/C++. 

PC-lintfor C/C++ $239 
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C source form. Call for pricing. 
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just closing the edit box. The remedy is 
identical to the one used above: when edit¬ 
ing begins, subclass the edit control and 
catch WM_GETDLGCODE and WM_CHAR. When 
handling WM_CHAR, detect VK_ESCAPE and 
VK_ENTER, and send the parent treeview 
window a TVM_ENDEDITLABELNOW mes¬ 
sage, setting the f Can cel parameter to 
TRUE if the Escape key was pressed, or to 
FALSE if the Enter key was pressed. Pass 
any characters other than these two on to 
the original handler. 

The New Treeview Control 

As the October and November 1996 
issues of Microsoft Systems Journal 
explain, there is a new version of the com¬ 
mon-control library (comctl 32 .dll) includ¬ 
ed with Microsoft’s Internet Explorer ver¬ 
sion 3. This new version won’t be “official¬ 
ly” released until Internet Explorer 4 ships, 
but apparently the majority of the new ver¬ 
sion’s features have been defined. Several 
new common controls have been added, and 
many of the original controls have been 
enhanced. (Incidentally, you needn’t use 
InitCommonControlsEx( ) to use the new 
features of the original controls.) 

There aren’t any revolutionary changes 
to existing treeview control behavior, but 
Microsoft added several new features. 
“Previewing the Common Controls DLL for 
Microsoft Internet Explorer 4.0, Part II,” by 
Strohm Armstrong ( MSJ , November 1996) 
says that the only enhancement unique to 
the treeview is the marginally useful ability 
to “partially expand” treeview items. 

Actually, there are several new tree- 
view style bits. For instance, 
TVS_PRIVATEIMAGELISTS (0x0040) tells the 
treeview to delete its imagelist(s) automati¬ 
cally when the treeview is destroyed. 
TVS_TRACKSELECT (0x0200) changes how 
selected items are drawn: besides drawing a 
shaded rectangle around the item, the 
item’s text is underlined and drawn in a dif¬ 
ferent color. TVSJ0T00LTIPS (0x0080) 
stops tooltip messages from being automat¬ 
ically sent to your treeview (although, by 
default, these messages are ignored any¬ 
way). TVS_SH0WSELALWAYS, although not a 
new style bit, has been modified: when the 
treeview doesn’t have focus, the selected 
item is drawn with a differently colored 
border so that it can be distinguished from 
the selected window. 

TVS_CHECKB0XES (0x0100) is the most 
ambitious of the new style bits. If you set 
the TVS_CHECKB0XES bit in the treeview’s 
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style DWORD, it will draw each item with a checkbox to the immedi¬ 
ate left of the item’s icon. The user can check or uncheck the boxes 
with the mouse. A program can tell whether or not an item is 
checked by sending TVM_GETITEM and examining the state field of 
the resulting TV_ITEM structure. In fact, there are four possible ways 
in which the checkbox can be drawn. If bit 0x1000 is on, this item’s 
checkbox is unchecked. If bit 0x2000 is on, the checkbox is 
checked. If both bits are on, no checkbox is drawn, but a space is 
left where the checkbox would have been. If neither of these bits is 
on, there is no checkbox and no space is left for it. 


Figure 2: Inside the HTREEITEM pointer 


I* The undocumented Treeview structure is below. An 
HTREEITEM is actually a pointer to one of these 
structures. */ 

typedef struct_TV INTERNALSTRUCT { 

HTREEITEM Parent; 

HTREEITEM Sibling; 

HTREEITEM FirstChild; 

LPCTSTR ItemText; // not valid under NT 
DWORD StateFlags; 

WORD ImagelD; 

WORD DontKnow; 

WORD VIewablelndexFromRoot: 

WORD Indentationlevel; 

DWORD IParam; // 1 Param from TVJTEM 
} TV INTERNALSTRUCT; 




SDK Annotation #160 


TYPE: Win32 
TOPIC: WM_MOVE 
KEYWORD: WM_MOVE 


The SDK documentation tells you to use the 
following two lines to calculate the x and y 
positions of the window after it has been 
moved. 

xPos - tint) LOWORDdParam); // horizontal position 

yPos - tint) HIWORD(lParam); // vertical position 

Though this worked fine in 16-bit Windows, it 
will fail for negative coordinates in 32-bit 
Windows. Instead use the following two lines to 
calculate the coordinates: 

// horizontal position 

xPos - tint) (short)L0W0RDI1 Pa ram); 

// vertical position 

yPos - (int)(short) HIWORDdParam); 

Submitted by Steven M. Kinney. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 


What if you need to add checkboxes to your treeview now, and 
don’t have time to wait until Internet Explorer 4 is released? 
Fortunately, it isn’t hard to implement checkboxes using the original 
version of the common controls. In fact, you can use the same state 
bits as the new version does. The new checkbox feature is actually 
implemented using an existing option in the treeview control, the 
“state imagelist,” which is an optional imagelist of pictures that are 
drawn to the immediate left of an item’s normal icon. You can give a 
treeview a state imagelist by sending a TVM_$ETIMAGELIST message 
with the WPARAM set to TVS I L_STATE. The state image used for each 
item is determined by four bits in that item’s state field (returned in 
the TV_ITEM structure when you send a TVM_GETITEM message). The 
important bits (0x1000, 0x2000, 0x4000, and 0x8000) can be masked 
with the TV I S_STATE IMAGEMASK value (defined as OxFOOO). If none 
of these bits are on, then no state image is drawn for that item. 
Otherwise, the state image is determined by shifting the state DWORD 
to the right 12 bits (which is what the INDEXT0STATE I MAGEMAS K() 
macro does). This produces an index into the state imagelist, indi¬ 
cating which picture to use for this item. Note that the index can be 
a value from 1 to 15, because the value of zero means that no image 
is drawn. Thus, the first entry in the state imagelist can’t be used. 
(The SDK explains that the index is “one-based,” but that wrongly 
implies that a value of 1 will use the first (Oth) index.) 

You can mimic the new built-in checkboxes in three steps. First, 
create an imagelist that contains four images depicting possible 
states: blank, unchecked, checked, and blank. Second, set the 
0x1000 state bit for each new treeview item, so that they all start by 
displaying the first image in your imagelist (presumably, you will 
put the unchecked box as the first image in your list). Finally, when 
the user clicks on an item, modify the state bits accordingly (toggle 
between the checked and unchecked images). 

You can make your program take advantage of the new style bit 
when the new DLL is present, and use your own imagelist when run¬ 
ning with the old DLL. To do this, create the treeview with 
TVS_CHECKB0XES. (The old common control DLL ignores this bit.) 
Before assigning a state imagelist to the control, call 
TreeVi ew_GetImageLi st( ) to see if the control already has a state 



Figure 3: A sample treeview application 
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Listing 1: tvdemo.c — Source for the demo application 


//define STRICT 
//include <windows.h> 

//include <stdio.h> 

//include <commctrl.h> 

//define ID_TV1 101 
/***************************************** 

Treeview Demo Program by Eric Heimburg 

In variable and function names, the 
abbreviation "TV" stands for "Treeview" 

*********** ****************************** j 

/*““ Reusable Utility Functions *1 
void ClientToWindow(HWND hWnd, POINT *Pt) { 

RECT wRect, cRect; 

GetWindowRect(hWnd, SwRect); 

GetClientRectlhWnd, ScRect); 

MapWindowPointsChWnd. HWNDJJESKTOP, (LPPOINTl&cRect, 2): 
Pt->x — (wRect.left - cRect.left); 

Pt->y — (wRect.top - cRect.top); 

) 

WN0PR0C SubclassWndCHWND hWnd, WNDPROC NewProc) { 

WNDPROC Old = (WNDPROC)GetWindowLongChWnd. GWL_WNDPR0C); 
SetWindowLong(hWnd. GWLJINDPROC, (LONG)NewProc); 
return Old; 

} 

char *TV_GetItemText(HWNO hTV, HTREEITEM hltem, char *Buf. 
size_t BufSIze) ( 

TV_ITEM tvitem; 
tvitem.hltem - hltem; 
tvitem.mask - TVIF_TEXT; 
tvitem.pszText - Buf; 
tvitem.cchTextMax - BufSize; 

TreeView_GetItem(hTV, itvitem); 
return Buf; 


BOOL TV_SetItemText(HWND hTV, HTREEITEM hltem, char ‘Text) { 
TVJTEM tvitem; 
tvitem.hltem - hltem; 
tvitem.mask - TVIFJEXT; 
tvitem.pszText - Text; 

return (TreeView_SetItemChTV, Stvitem) !- -1); 

} 

//define TV_CHECK_0FF (INDEXTOSTATEIMAGEMASK(l)) 

//define TV_CHECK_0N (INDEXTOSTATEIMAGEMASKC2)) 

BOOL TV_ToggleCheckMark(HWND hTV, HTREEITEM hltem) ( 

BOOL bWasOn; 

TVJTEM tvitem; 
tvitem.hltem - hltem; 
tvitem.mask - TVIF_STATE; 
if (TreeView_GetItem(hTV. Stvitem)) { 
bWasOn- ((tvitem.state & OxFOOO) — 0x2000); 
tvitem.state - (bWasOn ? 0x1000 : 0x2000); 
tvitem.stateMask - TVIS.STATEIMAGEMASK; 

TreeView_SetItem(hTV, Stvitem); 
return bWasOn; 

) 

else 

return FALSE; 


/*““ Subclassed Edit Control HndProc */ 

WNDPROC OrgEditProc; 

LRESULT CALLBACK EditProc(HWND hWnd, UINT uMsg, 

WPARAM wParam, LPARAM IParam) { 

switch (uMsg) { 
case UMJSETDLGCODE: 

return DLGC.WANTALLKEYS; 
case WM_CHAR: 

if ((wParam — VKJSCAPE) || (wParam — VK_RETURN)) { 
SendMessage(GetParentthHnd), TVM_ENDEDITLABELNOW, 

( (wParam - VKJSCAPE) ? TRUE : FALSE ), OL); 
return 0; 
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Listing 1: tvdemo.c — continued 


} 

} 

return CallWindowProctOrgEditProc, hWnd, uHsg, 


[ /****» Global variables */ 

1 BOOL bOragging - FALSE; 

HTREEITEM hStartingltem: 

1 WNDPROC OrgDragDropTVProc; 

I HINSTANCE hlnstance; 

: /*»*** Drag-and-drop Treeview Message Handlers */ 
void Scrol1DragDropTV(HWND hTV, BOOL bUp) { 

HTREEITEM hNext, hFirst - TreeView_GetFirstVisible(hTV); 

I lmageList_DragShowNolock(FALSE); 
if (hFirst — NULL) return; /* no items in tree */ 
hNext - TreeView_GetNextItem(hTV, hFirst, 
bUp ? TVGN_PREVIOUSVISIBLE : TVGN_NEXTVISIBLE); 
if (hNext) 

SendMessage(hTV, TVM.SELECTITEM, TVGN_FIRSTVISIBLE, 

(LPARAM)hNext); 

UpdateWindow(hTV); 

IraageLi st_DragShowNolock(TRUE); 

} 


#1fdef _BORLANDC_ 

//pragma argsused 
#endif 

LRESULT CALLBACK DragDropTVProc(HWND hTV, UINT uMsg, 

WPARAM wParam, LPARAM 1 Pa ram) { 
HTREEITEM hNewTarget, hOldTarget; 

TVJITTESTINFO ht; 

RECT r; 

char text[256], sl[256], s2[256]; 

switch (uMsg) { 
case WM_LBUTT0ND0WN: 
case WM_LBUTTONDBLCLK: 
ht.pt.x - L0W0RD(1Param); 
ht.pt.y - HIWORDdParam); 
hNewTarget - TreeView_H1 tTest(hTV, Sht); 
if (hNewTarget SS (ht.flags & TVHT_0NITEMSTATEICON)) { 
TV_ToggleCheckMark(hTV. hNewTarget); 
return 0; 

) 

break; 

case WM.MOUSEMOVE: 
case WM_TIMER: 
if (bDragging) { 

GetCursorPos(Sht.pt); 

ScreenToCTient(hTV. Sht.pt); 
hNewTarget - TreeView_HitTest(hTV, Sht); 
hOldTarget - TreeView_GetDropHi1ight(hTV); 

I lmageList_DragShowNol ock(FALSE); 

SendMessagethTV, TVM.SELECTITEM, TVGN_DROPHILITE, 
(LPARAM)hNewTarget); 

if ((hOldTarget !- hNewTarget) SS (hOldTarget)) ( 
TreeView_GetItemRect(hTV, hOldTarget, Sr, FALSE); 
InvalidateRectlhTV, Sr, TRUE); 

} 

ImageList.OragShowNolock(TRUE); 

MapWindowPoints(hTV, GetParent(hTV), Sht.pt, 1); 

ClientToWindow(GetPa rente hTV), Sht.pt); 

ImageList_DragMove(ht.pt.x, ht.pt.y); 

if (ht.flags S TVHT.ABOVE) 

Scroll DragDropTV(hTV, TRUE); 
else if (ht.flags S TVHT.BELOW) 

ScrollDragDropTV(hTV. FALSE); 
return 0; 

} 

break; 

case WM_LBUTTONUP: 
case WM.CAPTURECHANGED: 
if (bDragging) { 
bDragging - FALSE; 

GetCursorPos(Sht.pt); 

ScreenToClient(hTV. Sht.pt); 
hNewTarget - TreeView_HitTest(hTV. Sht); 
ReleaseCaptureO; 

M ImageList_DragLeave(GetParent(hTV)); 

ImageList_EndDrag(); 

ShowCursor(TRUE); 

SendMessagethTV, TVM.SELECTITEM. TVGN_DROPHILITE.0); 


KiIT Timer(hTV. 1); 

if (hNewTarget SS (uMsg !- WM.CAPTURECHANGED)) { 
TV_GetItemText(hTV, hStartingltem, sl.sizeof(sl)); 
TV.GetltemTextlhTV, hNewTarget, s2, sizeof(s2)); 
sprintf(text. "Dropped Is onto *s", si, s2): 
MessageBoxlhTV, text, MB.OK); 

) 

return 0; 


case HM.GETDLGCODE; 

if (bDragging) return DLGC_WANTALLKEYS; 
break; 

case WM.CHAR: 

if (wParam - VK.ESCAPE) { 
if (bDragging) 

ReleaseCaptureO; 

else 

SendMessagelGetPa rent(hTV).WM.CHAR,wParam. 1 Param); 
return 0; 

) 

break; 


return Cal 1 WindowProc(OrgDragDropTVProc, hTV, 
uMsg, wParam, IParam); 


LRESULT OnDragDropTVNotify(HWND hTV, NM.TREEVIEW *pHdr) { 
HWND hEdit; 

POINT pt; 

RECT r; 

HIMAGELIST hlml; 

TV.ITEM *pltem; 

switch (pHdr->hdr.code) { 
case TVN.BEGINLABELEDIT: 
hEdit - TreeView_GetEditControl(hTV); 

OrgEditProc - SubclassWndthEdit, EditProc); 
return TRUE; 
case TVN.ENDLABELEDIT; 
pltem - &((TV.DISPINFO*)pHdr)->iten; 
if ( pItem->pszText !- NULL) 

TV.SetltemText(hTV, pitem->hItem. pItem->pszText); 
return TRUE; 
case TVN.BEGINDRAG: 
bDragging - TRUE; 

SetFocus(hTV); 

ShowCursortFALSE); 

SetCapture(hTV); 
pt - pHdr->ptDrag; 

hStarti ngltem - pHdr->itemNew.hltem; 

/* create imagel1st with dragging-image in it */ 
hlml - TreeView.CreateDraglmagefhTV, hStartingltem); 
if (Ihlml) return FALSE; /* couldn't make image! */ 

/* begin dragging item */ 

TreeView.GetItemRect(hTV, hStartingltem, Sr, 1); 
ImageList_BeginDrag(hlml, 0, pt.x-r.left, pt.y-r.top); 
/* call ImageList_DragEnter. This function requires 
window coords, not client coords, so must convert. */ 
MapWindowPoints(hTV, GetParent!hTV), Spt, 1); 
ClientToWindow(GetParent(hTV), Spt); 
ImageL1st_DragEnter(GetParent(hTV), pt.x, pt.y); 
SetTimerlhTV, 1, 50, NULL); 
return TRUE; 

) 

return 0; 

) 


/**»** Func. to fill a treeview with 50 dummy items */ 
//define NUM.NORMALPICS 4 
(/define NUM.SPECIALPICS 4 

void Fi11Treeview(HWND hTV) ( 

TV.INSERTSTRUCT tvins; 

TV.ITEM tV1; 

HTREEITEM hltem; 
int loop; 
char text[256]; 

tvi.mask - TVIF.TEXT | TV IF.IMAGE | TVIF.SELECTEDIMAGE | 
TVIF.STATE; 

tvi.stateMask - TVIS.STATEIMAGEMASK; 

tvi.state - TV.CHECK.OFF; 

tvins.hParent - NULL; 

tvins.hlnsertAfter - TVI.LAST; 

for (loop - 0; loop < 50; loop++) { 
sprintf(text, "Item Bd", loop); 
tvi.pszText - text; 
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imagelist. If it does, then you’re running with the new common control 
DLL, so you don’t need to use your custom state imagelist. If it returns 
NULL, you’re running with the old DLL, so you need to assign your 
state imagelist to the control. Make sure to order the pictures in your 
state imagelist the same as in the imagelist used by the new common 
control DLL (that is, the first picture is blank, the second is an 
unchecked box, the third is a checked box, and the fourth is blank). 


Listing 1: tvdemo.c — continued 


tvi.cchTextMax - 1strlen(text); 

tvi. 11mage - (loop l NUMJORMALPICS); 

tvi.iSelectedlmage - (loop % NUMJORMALPICS); 

tvi ns. 1tem - tvi; 

hltem - TreeView_lnsertltem(hTV, tains); 
if ((loop % 10) - 0) 
tvi ns.hParent - hltem; 

} 

1 

/**»** H a i n Dialog Proc */ 

#ifdef _BORLANDC_ 

(/pragma argsused 
ilendif 

BOOL CALLBACK D1gProc(HWND hMnd. UINT uMsg, 

WPARAM wParam, LPARAM 1Parara) { 
HIMAGELIST hNormlml, hSpeciallml; 

HBITMAP hNormBmp, hSpecialBmp: 

switch (uMsg) t 
case UMJNITDIALOG: 

/* create image lists, fill, attach to Treeviews */ 
hNormlml - ImageList_Create(16, 16, 

ILC_C0L0RDDB, NUMJORMALPICS, 1); 
hSpeciallml - ImageList_Create(16, 16, 

ILCJOLORDDB. NUM_SPECIALPICS, 1); 
hNormBmp - LoadBitmapihlnstance, ”TVBITMAP"); 
hSpecialBmp - LoadBitmapihlnstance, "TVSPECIAL"): 
ImageList_Add(hNormlml, hNormBmp, NULL); 

ImageList_Add(hSpecialIml, hSpecialBmp, NULL); 

DeleteObjectlhNormBmp); 

DeleteObject(hSpecialBmp); 

SendMessagetGetDlgltemthWnd, ID_TV1), 

TVM.SETIMAGELIST, TVSILJORMAL, (LPARAM)hNormlml): 
SendMessagetGetDlgltem(hWnd, ID_TV1), 

TVM.SETIMAGELIST, TVSILJTATE, (LPARAM)hSpecialIml); 

Pi 11Treeview(GetDlgltemthWnd, ID_TV1)); 
OrgDragDropTVProc - SubclassUndt 

GetDlgltem(hWnd, ID_TV1), DragDropTVProc); 
return TRUE; 
case WM_CL0SE: 

EndDialog(hWnd. IDCANCEL); 
break; 

case UM_C0MMAND: 

if ( (wParam — MAKELPARAMIIDOK, BN_CLICKED)) || 
(wParam - MAKELPARAMtIDCANCEL, BNJLICKEO)) ) 
EndDialog(hWnd, LOWORD(wParam)): 
break; 

case NMJOTIFY: 
if (wParam — ID_TV1) 
return OnDragDropTVNotify( 

GetDlgltemlhWnd, IDJV1), (NM_TREEV IEU*) 1 Pa ram); 
break; 
default; 
return FALSE; 

1 

return TRUE; 


/***** NinMain function *1 

#ifdef _BORLANDC_ 

((pragma argsused 
#endif 

int PASCAL WinMain( HINSTANCE hlnst, HINSTANCE hPrevInst, 
LPSTR CmdLine, int nCmdShow ) { 
InitCommonControlsO; 

hlnstance - hlnst: /* initialize global variable */ 

if (DialogBoxthlnst, "MAINDLG", NULL, OlgProc) -- -1) 
MessageBox(0, "Couldn't create main dialog”, 0, MBJK); 
return 1; 

} 

/* End of File */ 


The Internal Treeview Structure 

Although intended as an opaque handle, an HTREEITEM is actually a 
pointer to a 32-byte internal structure, most of which I’ve reverse-engi¬ 
neered. The simplicity of this structure lends itself to use as a debug¬ 
ging aid. The C syntax for the structure is shown in Figure 2. 

A few of the structure’s fields need explanation: the 
Vi ewabl elndexFromRoot field is -1 for items that aren’t expanded 
(that is, their parents haven’t been double-clicked on). For expanded 
items, the value in this field gives the order in which the items 
appear when scrolling the treeview up or down. 

The Parent field is a pointer to the item’s parent, but root-level 
items don’t have NULL for this value, as you might expect. Instead, 
they point to another item (which is always invisible), and this hid¬ 
den item has a NULL Parent field. 

Most of the information in this structure can be determined via 
other documented methods, though the documented methods can be 
a little bothersome to use. For example, to determine an item’s 
indentation level, you get its parent item, and then get the parent’s 
parent, and so on, counting the number of times you do this until 
there are no more parents. I can think of no reason for using this 
internal structure in a program’s release version. In the debugging 
version, however, it can prove very valuable. If you use assert() 
macros (or similar sanity checks) in your code, you can use this 
internal structure in those calls. For instance, to assert that an 
HTREEITEM has no children: 

assertt ((TVINTERNALSTRUCT*) 
hTreeItem)->Fir$tChild — 0 ); 


Communications 

Do you need to make your Application communicate over a COM 
port? You need to send messages to electronic pagers? You need to 
clear credit cards using the VISA protocol? Need your Data Base to 
be a client or server or transfer data files? Need to have your 
application talk to a modem, a mainframe, another PC, an electronic 
pager, a bank, or custom hardware? Now you can do this and more 
using CrystalCOMM. You need the unusual? We do it. 

CrystalCOMM for Windows $175 

CrystalCOMM supports development of modem or serial port 
communication programs from your application. CrystalCOMM is a 
DLL that supports XMODEM, ZMODEM, KERMIT, CompuServe, 
VISA, TAP electronic pager, and ASCII protocols through a simple, 
structured function interface. Supports up to 9 ports at high speed. 
Examples include client-server queries over communications links. 
Library includes DLLs, examples, and documentation. Use our 
CrystalCOMM for NT/WIN95 version to run your 32 bit NT or 
WIN95 application program on up to 128 ports concurrently. 
CrystalCOMM for NT/WIN95 - $200. 

Visit us at: www.crystalcom.corn 


Crystal 

Software (906)822-7994 

Inc. 

P.O. Box 247, Amasa, MI 49903 , USA - FAX (906) 822-0219 
crystal@up.net 
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If you don’t mind altering commctrl .h, you can modify the defini¬ 
tion of HTREEITEM so that, when compiled in debugging mode, it is a 
pointer to a TVINTERNALSTRUCT. (When not in debugging mode, it 
can be defined as a pointer to a dummy structure, as it is defined in 
the original commctrl. h.) With this change, your integrated debug¬ 
ger can keep track of various fields when you place an HTREEITEM in 
a watch statement. 

This structure appears to be relatively stable, as undocumented 
structures go: both versions of comctl 32.dll (the one that shipped 


Listing 2: tvdemo.rc — 
tvdemo.exe 

Resource definitions for 

#1fndef W0RKSH0P_INVOKED 
#include (windows.h> 

#e n d i f 

♦define ID_TV1 101 

TVBITMAP BITMAP "tvbitmap.BMP" 
TVSPECIAL BITMAP "tvchecks.BMP" 

MAINDLG DIALOG 0, 0, 264, 235 
EXSTYLE US EX APPWINDOW 


STYLE DS MODALFRAME | DS 3DL00K 

\ WS OVERLAPPED | 

WSJISIBLE 

CAPTION "Treeview Demo Program" 
FONT 8, "MS Sans Serif" 

f 

| WS_CAPTION | WS_SY$MENU 

1 1 

CONTROL "TreeViewl". ID.TVl, " 

SysTreeView32", 15 1 

WS CHILD I WS VISIBLE | WS BORDER | WS TABSTOP, 

36, 32, 192, 172 

1 


with Windows 95, and the new one that is included with Internet 
Explorer 3) use this structure. 

TreeView_XXXX Macro Problems 

The TreeVi ew_XXXX macros provide “wrappers” for the 
TVM_XXXX window messages. These macros have problems under 
Borland C/C++ v5.0: they generate warnings. Most of the wrapper 
macros return a value; the macros typecast the result of 
SendMe$sage( ) into the appropriate type. However, if you don’t use 
the return result, this typecast is not useful, and BC5 flags this with 
the warning “Code has no effect.” When using a class library in 
C++, you don’t usually need the macros because your treeview class 
provides functions to replace them. When using C, however, you 
will have to decide whether the clarity of using the macros out¬ 
weighs the confusion caused by the warning messages. In my sam¬ 
ple C code, I use macros only when I need the return result; other¬ 
wise, I call SendMessage( ) directly. 

Another problem with the macros is that some of them return 
the wrong result type. TreeVi ew_Sel ect(), 
TreeView_Selectltem(), Treeview_SelectDropTargett ), and 
TreeVi ew_Sel ectSetFi rstVi sibl e( ) typecast their return results 
into HTREEITEMs, but they are documented as returning BOOLs. 
(They do, in fact, appear to return zero or one, so this is a rare case 
where the documentation is right and the header file is wrong.) 
TreeView_SetIndent( ) returns a BOOL, but the message that it 
sends, TVM_SETI NDENT. doesn’t really return a meaningful value 
(and the documentation describes it as returning void). The new 
version of the header file (included with the ActiveX Developer’s 
Kit CD) does not fix these errors. 


Prolndex 


Full-Text Indexing and Retrieval 
Development Toolkit! 


Powerful 


Unlimited document size and quantity 
Full control of document parsing 
Keyword, Boolean, Wildcard 
Phrase, Proximity 
Paraphrase, Delimited Search 
Multi-level nested expressions 

Dynamic 

Full multi-user support 

Works with LAN, WAN, and Internet 
Simultaneous indexing and retrieval 

Efficient index base tuning 


Portable 

DOS, Windows (3.1, NT, 95), 

OS/2, Macintosh, NeXT, Unix 

C/C+ +, VB, Delphi, and others 

Unicode, Asian, and European 
character support 

Fast 

Unequaled indexing speed 
Fast complex searches 
Find the EXACT location of a search 
Perfect for CD-ROM Applications! 

_ ) 


(7 InfoSphere 

Enhancing the accessibility of informationI 

PO Box 225, Pleasant Grove, UT 84062 
(801)221-5902 Fax (801) 221-5903 



□ Request Reader Service #137 □ 


The Sample Code 

The sample Win32 C program in tvdemo.C (Listing 1) and 
tvdemo.rc (Listing 2) has been tested with Borland and Microsoft 
compilers. It demonstrates drag-and-drop with auto-scrolling, how 
to implement checkboxes with the original version of the common 
controls DLL, and how to correctly implement a treeview in a dia¬ 
log. For brevity, I used only one treeview (see Figure 3) to show 
both drag-and-drop and checkboxes, but in a real program, using 
checkboxes in a drag-and-drop treeview is probably too confusing. 
The difficulties arise because clicking on a treeview item can do too 
many things: expand a parent item, begin editing, toggle a check¬ 
box, or begin a drag-and-drop operation. If you need all these fea¬ 
tures at once, consider using the Shift, Ctrl, or Alt keys to discrimi¬ 
nate between the various actions. 

A second sample program, available on the electronic distribu¬ 
tion (see Table of Contents for availability), illustrates scrolling for 
a non-drag-and-drop treeview and demonstrates the use of the inter¬ 
nal structure. It also automatically uses the built-in checkmark 
imagelist when run under the new DLL. □ 
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Paula Tomlinson 

Understanding NT 



I had intended to occasionally cover NT device driver questions 
and issues in this column, but I often receive questions that are a lit¬ 
tle too specific to be of interest to a large audience. Recently, howev¬ 
er, several readers have asked general questions about claiming hard¬ 
ware resources from an NT device driver, and specifically about call¬ 
ing IoReportResourceUsagel ). Some readers had trouble with the 
automatic event logging feature of IoReportResourceU$age( ), and 
others had trouble interpreting the data structures used by Windows 
NT to describe hardware resources. These are perfect examples of 
problems many device driver writers run into (and I myself ran into 
the first time I wrote a driver). You’ll need a copy of the NT DDK to 
follow this month’s column. 

Claiming Hardware Resources 

Before an NT device driver accesses any of the resources 
associated with its device (I/O ports, DMA channels, memory 
addresses, or interrupts), it must claim those resources for its own 
use. A driver typically claims resources by calling one of the fol¬ 
lowing I/O Manager routines: IoReportResourcellsage(), 
IoAssignResourcest ), or HalAssignSlotResources (). All three 
routines require a driver object as a parameter and let you pass a 
device object as an optional parameter. If you don’t pass in a device 
object, then the resources specified will be claimed for the driver 
itself (and all device objects it created, if any). On the other hand, if 
the driver creates multiple device objects, you can claim different 
resources for each device object by specifying the device object 
when you claim the resource. After your driver successfully claims 
a set of resources (by calling one of the previously mentioned rou¬ 
tines), NT records that set of resources in the registry under 

\Registry 

\Machine 

\Hardware 

\ResourceMap 

(for user-mode code, the \Regi stry\Machi ne path corresponds to 
HKEY_LOCAL_MACH INE). Once claimed, a resource cannot be claimed 
by any other device drivers. 

Figuring out which of the three routines to call is usually the first 
problem driver writers encounter. According to the Windows NT 
DDK documentation, HalAssignSlotResourcesO is used only for 
devices on a “dynamically configurable I/O bus with a published 
standard interface.” For practical purposes, this currently means 
devices on a PCI bus, but there certainly may be other such I/O 
buses in common use in the future (such as USB, perhaps). 


Paula Tomlinson has been developing DOS, Windows and Windows-NT based 
applications and device drivers for nine years. The opinions expressed here are 
hers alone. She can be contacted via the internet at paulat@microsoft.com. 


That leaves IoAssignResourcesC ) and 

IoReportResourceUsagel ). These names imply that one of these 
functions claims resources and the other merely reports on what 
resources are available, but that’s not true — they both reserve 
resources for your driver. The principle difference is that with 
IoAssignResourcesC ), you can pass multiple sets of resources and 
the function tries to locate and claim a set that is available. For 
example, if the hardware controlled by your driver needs to use 
either I NT 5h and I/O port 308h, or I NT 7h and I/O port 408h, you 
can pass that information to IoAssignResourcest ) and it will 
determine which combination (if either) is currently available. With 
IoReportResourceUsaget ), on the other hand, you can pass only in 
one set of resources. You might decide to call 
IoReportResourceUsagel ) if your device is not configurable (e.g., 
it absolutely must have I NT 5h and I/O port 308h), or if you have 
already done the work of determining which resources are available 
by calling resource query functions in the DDK. 

The Big Data Structure 

IoAssignResourcesl ) can handle complicated requests such as: 
“I need I NT 5h and also I/O ports 308h-30Ah, but if that’s not avail¬ 
able, I could instead use I NT 7h and I/O ports 408h-40Ah.” However, 
the cost of that functionality is a fairly complicated data structure 
that you must fill out. Figure 1 shows the structure definition for 
IO_RESOURCE_REQUIREMENTS_LIST, the complicated “list of lists” 
data structure for specifying lists of resources. Figure 2 provides a 
high-level schematic of this structure. 

At the top-most level, you are passing a list of one or more 
resource lists, where each resource list specifies a separate set of 
resources that your device could live with. If IoAssi gnResources() 
finds that all the resources in one of these resource sets is available, 
then it claims that set of resources for your driver. In other words, 
the resource lists are effectively ORed together — 
IoAssignResourcest ) will succeed if it can satisfy the demands of 
any one of the resource lists. 

At the next level of detail in Figure 2, each individual resource list 
(IO_RESOURCE_LIST) contains a list of resource descriptors 
(IO_RESOURCE_DESCRI PTOR), where each resource descriptor identifies 
a single hardware resource (a range of port I/O addresses, a range of 
interrupts, a range of memory, or a DMA channel). 

You can effectively AND or OR the individual resource descriptors 
in a resource list by how you set the Option field in each 
IO_RESOURCE_DESCRI PTOR. By default, each descriptor in the 
resource list is ANDed together — all the resources referred to must be 
available. However, if you turn on the IO_RESOURCE_ALTERNATIVE bit 
in the Opti on field of a resource descriptor, it is ORed with the previ¬ 
ous resource descriptor — only one of them need be available. For 
example, if you have three resource descriptors that refer to, in order, 
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I NT 5h, I/O port range 308h-30Ah, and I/O port range 408h-40Ah, 
then all three resources must be available for that resource list to be 
claimed. However, if you took the same three resource descriptors 
and turned on the IO_RESOURCE_ALTERNATIVE bit in the Opti on field 
of the last descriptor, then the resource list refers to I NT 5h and 
either of the two I/O port ranges — only one of the two ranges must 
be available, and only one of them will be reserved for your driver if 
the entire resource list is valid. 

Structures for loAssignResources() 

Because 10_RES0URCE_REQU I REMENTS_LIST is so complicated to 
initialize correctly, I will work through a specific example in detail. 
Consider a device that can support either of the following two 
resource sets: 


SDK Annotation #161 

TYPE: MFC 4.x 
TOPIC: CWnd::OnMove 
KEYWORD: CWnd::OnMove 

MFC supplies LOWORD (IParam) and 
HIWORD (IParam) of the WM_MOVE message 
for the x and y parameters of this function, 
respectively. Since x and y are defined as 
integers, you will get very large numbers for 
negative coordinates. 

Whenever you want to handle the WM_MOVE 
message, do the following: 

1. Define a message handler: ON_MESSAGE 
(WM_MOVE, OnMyMove) in the message 
map. 

2. Write the OnMyMove function as follows: 

LRESULT ClassName::0nMyMove (WPARAM, LPARAM IParam) 

{ 

// horizontal position 
x - tint) (short)LOWORDt1Param); 

// vertical position 
y = (intXshort) HIWORDOParam); 

// Do your processing here ... 

return Default 0; 

1 



Submitted by Steven M. Kinney. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 


1. (Interrupt 5) and (4 I/O ports, from 300-307h or from 308-30Fh) 

2. (Interrupt 7) and (4 I/O ports, from 400-407h or from 408-40Fh) 
To represent the above list of resource sets, first set the 
Alternati veLists field in your 10_RES0URCE_REQUIREMENTS_LIST 
structure to 2 (to indicate there are two resource sets in the list). 
The resource sets themselves are stored in the variable-length 
10_RE SOU RC E_L 1ST array at the end of the 
10_RES0U RCE_REQUI REMENTS_LI ST structure. Notice that NT often 
represents variable-length arrays as a single-element array 
(List[l], in this case) combined with another integer field 
(AT ternati veLi sts, in this case) that specifies the number of ele¬ 
ments in the array. That typically means you have to calculate the 
size of the total structure (I’ll provide a formula later), ma 110C() 
that much memory, and then cast it to an 
10_RES0U RC E_REQU I REM E NTS_L I ST pointer. You can then refer¬ 
ence each resource list as an element in the array, even though it 
was declared to have only one element 

Each IO_RESOURCE_LIST structure in the List array contains 
another variable-length IO_RESOURCE_DESCRI PTOR array to describe 
each hardware resource. The 1 0_RES0URCE_DESCRIPTOR structure 
contains a discriminated union of structures that represents each 
hardware resource type. The Type field specifies which union mem- 


Figure 1: Definition of 
IO RESOURCE REQUIREMENTS LIST 


typedef struct _IO_RESOURCE_DESCRIPTOR { 

UCHAR Option; 

UCHAR Type; // CM_RESOURCE_TYPE 

UCHAR ShareDisposition; // CM_SHARE_DISPOSITION 

UCHAR Sparel; 

USHORT Flags; // CM resource flags 

USHORT Spare2; // align 

union { 
struct { 

ULONG Length; 

ULONG Alignment; 

PHYSICAL_ADDRESS MinimumAddress; 

PHYSICAL.ADDRESS MaximumAddress; 

1 Port; 
struct { 

ULONG Length; 

ULONG Alignment; 

PHYSICAL_ADDRESS MinimumAddress; 

PHYSICAL_ADDRES$ MaximumAddress; 

} Memory; 
struct { 

ULONG MinimumVector; 

ULONG MaximumVector; 

) Interrupt; 
struct { 

ULONG MinimumChannel; 

ULONG MaximumChannel; 

} Dma; 

1 u; 

) IO_RESOURCE_DESCRIPTOR, *PIO_RESOURCE_DESCRIPTOR; 

typedef struct JO_RESOURCE_LIST ( 

USHORT Version; 

USHORT Revision; 

ULONG Count; 

IO_RESOURCE_DESCRIPTOR Descriptors[1]; 

} IO_RESOURCE_LI ST, *PIO_RESOURCE_LIST; 

typedef struct _IO_RESOURCE_REQUIREMENTS_LIST ( 

ULONG ListSize; 

INTERFACE_TYPE InterfaceType: 

ULONG BusNumber; 

ULONG SlotNumber; 

ULONG Reserved[3]; 

ULONG AlternativeLists; 

IO_RESOURCE_LIST Listfl]; 

} IO_RESOURCE_REQUIREMENT$_LIST, *PIO_RESOURCE_REQUIREMENTS_LIST; 
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ber is present, and should be set to one of the values in the 
CM_RESOURCE_TYPE enumerated type. The Flags field contains 
resource type flags defined in ntddk. h. 

For the sample device I am describing, the first resource set 
describes three different hardware resources: INT 5h, port 300-307h, 
and port 308-30Fh. Notice that the interrupt and the ports have an AND 
relationship, while the two port ranges have an OR relationship (the 
device requires a single interrupt and either one of the two port 
ranges). As mentioned earlier, you can define these AND and OR relation¬ 
ships with the presence or absence of the IO_RESOURCE_ALTERNATIVE 
bit in the Opt i on field of each resource descriptor. If the bit is on, this 
resource descriptor has an OR relationship with the one that preceeds it; 
otherwise, it has an AND relationship. So, assuming that the first 
resource descriptor in this example refers to the interrupt, then the last 
descriptor must have its IO_RESOURCE_ALTERNATIVE bit turned on 
because the last two descriptors (the I/O ports) are to be ORed. 

When you use the IO_RESOURCE_ALTERNATIVE bit to OR several 
resource descriptors together, you can indicate which of the choices is 
preferred by turning on an additional bit: IO_RESOURCE_PREFERED. 

In Figure 3, I’ve listed what the IO_RESOURCE_REQUIREMENTS_LIST 
structure might look like for this sample device. As mentioned earlier, 
you must dynamically allocate this structure to account for the vari¬ 
able-sized arrays. You can use the following formula to determine the 
size (in bytes) of the IO_RESOURCE_REQUIREMENTS_LIST structure: 

// I have two resource lists 
int NLists = 2; 

// the lists describe a total of 6 resources 
int NDescriptors = 6; 

Size = sizeof(IO_RESOURCE_REQUIREMENTS_LIST) 

+ (NLists-1)* sizeof(IO_RESOURCE_LIST) 

+ ((NDescriptors-NLists) 

* sizeof(IO_RESOURCE_DESCRIPTOR) 

); 


IO_RESOURCE_REQUIREMENTSJJST 


IO_RESOURCE_LIST #1 


IO RESOURCE DESCRIPTOR #1 


IO RESOURCE DESCRIPTOR #n 


IO_RESOURCE_LIST #n 


IO RESOURCE DESCRIPTOR #1 


IO RESOURCE DESCRIPTOR #n 


Fi g u re 2: The list of resource lists structure 


Figure 3: Sample 

10 RESOURCE REQUIREMENTS LIST structure 
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(continued) 
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more than Just a Database Browser 



Edit[T]able 

The purpose of Edit[T]able is to provide a table structure on screen as an 
interface between an end user, browsing or typing in data, and the application 
managing the data. Edit[T]able DLL is database independent. 

The transfer between the end user and the DLL is supported by WINDOWS", 
the transfer between the DLL and the application is done via classes and calls 
to their virtual functions, i.e. the functions are coded in the application, but 
called from the Edit[T]able DLL. 

In C applications, the virtual functions are replaced by function pointers. 
Supported field types: 

String Integer Long Float Double Date Time 

The layout and the attributes of the table structure and the fields are to be 
defined with a separate design tool(induded), so that you can change these 
attributes without re-compiling the application. 

A free demo disk with examples for linked list, array structure and PARADOX® 
Engine is available. 
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Figure 3: 
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Basic Scripting 


Cypress Enable 3.0 
Basic Scripting for Applications 

A Powerful, complete, royalty free, VBA compatible 
Basic Scripting Language. Cypress Enable Features: 

OLE Automation, small footprint < 200k, Dynamic 
Dialogs, Dialog Editor, Editor/Debugger with source 
code, extensible syntax, save/load compiled code, 
printed and online documentation, huge script 
capacity, On Error, For...Each and With statements, 
easy access to objects, variables and functions in your 
application, extremely powerful API, logical and easy 
to use, integrate in a matter of hours . Supports 16 & 
32 bit Windows, MAC, UNIX and DOS. 60 day money 
back guarantee, 16bit $495, 32bit $595. Free 
whitepaper. Order Today! 1-800-790-4050. 

Cypress Enable has shipped in over 2,000,000 
products worldwide! 


Son 



Cypress Software Inc. 

Http://www.cypressinc.com , Fax (602) 951-8047 
Phone (602) 922-4883, email cypress'fl cypressinc.com 
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Structures for loReportResourcellsage() 

Calling IoReportResourceUsagel ) is somewhat simpler, since 
you must specify only one set of resources rather than a list of alter¬ 
native resource sets. The main data structure for this routine is 
CM_RES0U RC E_L I ST, shown in Figure 4. While this structure is a lit¬ 
tle more straightforward, it still contains two variable-length arrays. 
The CM_PARTIAL_RESOURCE_DESCRIPTOR structure describes each 
hardware resource. An interesting point about the 
CM_PARTI AL_RESOURCE_DESCRI PTOR is that you can include private 
data by specifying a Type of CmResourceTypeDeviceSpecif ic. If 
you will be using private data, it must be the last descriptor in the 
CM_P ART I A L_RES0U RC E_L I ST. Given the same set of usable 
resources from the previous sample device, assume that the driver 
actually claims Interrupt 5 and I/O port 302-305h. Figure 5 illus¬ 
trates a dump of the corresponding CM_RESOURCE_L 1ST structure. 

If you’re still not sure whether you are correctly filling out 
these structures, you might try just writing them out to the reg¬ 
istry and then use regedt32.exe to view them. REGEDT32 


Figure 4: Definition of CM__RESOURCE_LIST 


typedef struct _CM_PARTIAL_RESOURCE_DESCRIPTOR { 

UCHAR Type; 

UCHAR ShareDisposition; 

USHORT Flags; 
union ( 

struct { 

PHYSICALADDRESS Start; 

ULONG Length; 

} Port; 

struct { 

ULONG Level; 

ULONG Vector; 

ULONG Affinity; 

} Interrupt; 

struct { 

PHYSICALJDDRESS Start; 

ULONG Length; 

} Memory; 

struct { 

ULONG Channel; 

ULONG Port; 

ULONG Reservedl; 

} Dma; 

struct { 

ULONG OataSize; 

ULONG Reservedl; 

ULONG Reserved?; 

} DeviceSpecificData; 

1 u; 

} CM_PARTIAL_RESOURCE_DESCRIPTOR, *PCM_PARTIAL_RESOURCE_DESCRIPTOR; 

typedef struct _CM_PARTIAL_RESOURCE_LIST { 

USHORT Version; 

USHORT Revision; 

ULONG Count; 

CM_PARTIAL_RESOURCE_DESCRIPTOR PartialDescriptorstl]; 

1 CM_PARTIAL_RESOURCE_LIST, *PCM_PARTIAL_RESOURCE_LIST; 

typedef struct _CM_FULL_RESOURCE_DESCRIPTOR { 

INTERFACE.TYPE InterfaceType; 

ULONG 8usNumber; 

CM_PARTIAL_RESOURCE_LIST PartialResourceList; 

} CM_FULI_RESOURCE_DESCRIPTOR, *PCM_FULL_RESOURCE_DESCRIPTOR; 

typedef struct _CM_RESOURCE_LIST { 

ULONG Count; 

CM_FULL_RESOURCE_DESCRIPTOR L1st[l]; 

} CM_RESOURCE_LIST, *PCM_RESOURCE_LIST; 
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knows how to interpret these structures and displays them in a 
conveniently formatted way. If REGEDT32 doesn’t display them 
correctly, then you are probably not filling in the structures cor¬ 
rectly. To write a CM_RESOURCE_LIST structure to the registry, 
specify REG_RES0U RC E_L I ST as the registry value data type. 
Likewise, when writing a 10_RES0U RCE_REQU I REMENTS_L 1ST to 
the registry, specify REG_RES0URCE_REQU I REMENTS_L 1ST as the 
registry value data type. 

Which to Call? 

After reading that detailed description of the structures they 
take, it should be easier to decide which function is right for your 
driver. Here are the function prototypes for IoAssignResources() 
and IoReportResourceUsageO: 

NTSTATUS IoAssignResources ( 

IN PUNICODE_STRING RegistryPath, 

IN PUNICODE_STRING DriverClassName, 

IN PDRIVERJBJECT DriverObject, 

IN PDEVICEJBJECT DeviceObject, 

IN P10_RESOURCE_REQUIREMENTS_LIST 
RequestedResources, 

IN OUT PCM_RESOURCE_LIST * AllocatedResources ); 

NTSTATUS IoReportResourceUsaget 

IN PUN I C0DE_STRI NG DriverClassName, 

IN PDRIVER.OBJECT DriverObject, 

IN PCM_RESOURCE_LIST DriverList, 

IN ULONG DriverListSize, 

IN PDEVICE.OBJECT DeviceObject, 

IN PCM_RESOURCE_LIST DeviceList, 

IN ULONG DeviceListSize, 

IN BOOLEAN OverrideConflict, 

OUT PBOOLEAN ConflictDetected ); 
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This function is incorrectly documented as 
returning BOOL. It actually returns void. 

This documentation error has been corrected in 
MFC 4.x 
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You pass IoReportResourceUsageO a CM_RESOURCE_LIST struc¬ 
ture rather than an 1 0_RES0URCE_REQUI REMENTS_L 1ST structure, 
which means that callers of IoReportResourceUsageO must 
already have a specific set of hardware resources in mind. In gener¬ 
al, if you are calling functions like IoQueryDevi ceDescri pti on() 
to determine which hardware resources are available, you will 


Figure 5: Sample CM RESOURCE LIST structure 
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Pounding a round peg 
through 
a square hole... 


Supports Oracle, Sybase, SQL Server, 
DB 2 , BDE, Streams, Visual C++. 
Borland C++. VisualAge C++ 

Windows 95 /NT, and OS/ 2 . 


Check out our web site or call for all the details 
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Easy to use, easy to integrate 
Unparalleled mapping services 
Powerful Object-SQL queries 
Writes all necessary C++ code 


...is not much different than storing objects in a standard 
database. The Secant Persistent Object Manager lets you 
map your C++ objects to today's databases and seamlessly 
move to tomorrow's universal servers. 


Homepage: www.secant.com Telephone: 216.595.3830 
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likely have determined the exact resource set you intend to use, and 
will call IoReportResourceUsaget). IoQueryDeviceDescription() 
returns information about devices that are detected by the system (via 
NTDETECT, ARC firmware, or the BIOS). 

When drivers call IoAssi gnResources (), they pass in a list of 
alternate resource sets (an IO_RESOURCE_REQUIREMENTS_LIST struc¬ 
ture). IoAssignResourcesO, if possible, selects a resource set 
whose elements have not already been claimed by another driver 
and returns that set back to the caller in the form of a 
CM_RES0U RC E_L I ST structure. If your driver works with devices 
whose hardware requirements are configurable, you may want to 
call IoAssignResourcesO and let it do the work of determining 
which combination of resources is available. 

Drivers that call IoAssignResourcesO can still call 
IoReportResourceUsaget ). Typically, this is done if a driver needs 
to store device-specific information, since 
IoReportResourceUsaget) supports that extra information and 
IoAssi gnResources () does not. To call IoReportResourceUsage, a 
driver would add the device-specific data to the CM_RESOURCE_L 1ST 
structure returned by IoAssignResourcesO and pass that updated 
structure to IoReportResourceUsaget). 

Common Misconceptions 

The first common mistake made when calling 
IoReportResourceUsaget) or IoAssignResourcesO is attempting 
to call it multiple times to claim multiple resources. While it is per¬ 
fectly valid to call either routine multiple times, each call (with the 


Let’s face it: One-channel sound just doesn’t cut it 
anymore. If you want real sound, you need 
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□ Up to 16 sound channels 
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□ Window message when sound done 

□ Sequence one sound after another 

□ C/C++, VB, and Delphi 

□ 16- and 32-bit DLLs 

□ Windows 3.1, Win32s, 95, and NT 

□ Sound files up to 2G 

"Considering its ease of use, quality, power, 
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same device/driver) simply replaces the previous list of claimed 
resources for that device/driver. If you want to simply release all 
resource claims made by the device/driver, then you can call 
IoReportResourceUsaget ) with an empty CM_RESOURCE_LIST 
structure (set the Count field to zero in the DriverLlist or 
DeviceList parameter) or call IoAssignResourcesO with a NULL 
RequestedResources parameter. 

Another problem developers have with 
IoReportResourceUsaget ) is understanding how the 
OverrideConf 1 i ct parameter works. If you pass FALSE for 
OverrideConfl i ct and NT detects a conflict with the requested set 
of resources, it will not write the resources to the ResourceMap (in 
the registry), and will write a message to the event log. In most 
cases, it’s a good idea to use the default value of FALSE so users can 
be warned of the resource conflict by reading the event log entry. A 
case where you might need to set the Overri deConf 1 i ct parameter 
to TRUE is if your driver can recover gracefully on its own from the 
resource conflict (such as choosing an alternate resource set, etc.). 
Note that by setting the Overri deConf 1 i ct parameter to TRUE, you 
prevent the event from being logged, but you also allow the con¬ 
flicting resources to be written to the ResourceMap in the registry. 

Note also that while IoReportResourceUsaget ) automatically 
writes to the event log (if a conflict occured and Overri deConflict 
is set to FALSE), its up to the driver to supply the event log message 
in its message file. So, if your driver calls 
IoReportResourceUsaget ) with the Overri deConflict parameter 
set to FALSE, then it must be registered as an event log source and it 
must provide an event ID of 22 (which is the designated event ID 
that IoReportResourceUsaget ) uses to log resource conflict 
events). The documentation is, unfortunately, not very clear in 
pointing out that drivers must supply the message themselves and 
that the ID is 22. 

Windows NT News: Phasing out MIPS 

Microsoft announced on October 16 (1996 PR News wire) that it 
would be “phasing out future development and engineering efforts 
for the MIPS platform.” The reason cited for this decision was 
decreasing demand for MIPS-based systems and the fact that NEC 
(the largest OEM for MIPS systems) has decided not to provide 
MIPS systems beyond the 4.0 version of the Windows NT operating 
system. Microsoft indicates they will continue to support Windows 
NT 4.0 on the MIPS platform. For the long term, however, high-end 
customers would be wise to start considering an alternate platform 
(x86, Alpha, or PowerPC). 
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Reader Profile 


An Interview with David Plass 


Name: David Plass 

Title: Director of Software Development 

Company: Schick Technologies 

Years programming: 15, 6 professionally 

Years programming Windows: 2.5 

Other O/S experience: Unix (Sun/OS), Mac 

Company size: ~ 125 employees, 4 full-time programmers 

Principal compiler: Visual C++ 

David Plass is Director of Software Development at Schick 
Technologies, Inc. Besides four full-time programmers, they have 
about 20 people in “engineering,” which consists of Electrical, 
Mechanical, Software, Product Support, and Materials engineers. 
David replied to an editorial question I posed in the October issue, 
and he agreed to be the guinea pig for the premiere installment of 
this column. 

Windows Developer’s Journal: Tell us a bit more about what your 
company does. 

David Plass: Schick Technologies designs, manufactures, and sells 
Computed Dental Radiography (CDR), which is an imaging system 
for dentists. An x-ray-sensitive sensor is used instead of film to take 
x-rays in the patient’s mouth. In addition, full-color video images 
can be captured from any video camera. The CDR software per¬ 
forms the following functions: 

• Set up the x-rays to be taken 

• Acquire the x-rays from the hardware 

• Display the x-rays with the usual image manipulation functions 
(zoom, contrast enhance, annotate) 

• Print images either singly or in reports on a variety of printers 

WDJ: You replied to my editorial question, “Is anyone seriously 
relying on Win32s to give their app Win3.1 support?” with an 
emphatic “Yes” — please elaborate. 

DP: Our users are dentists, some of whom saw and touched a comput¬ 
er for the first time when they purchased our product. They are notori¬ 
ous for not wanting to change something that works, so the many users 
who are using Win 3.1 will not want to upgrade to Windows 95 (or 
NT) when we release the 32-bit version of our software. So, we are 
relying on Win32s as the Windows 3.1 solution. It sure beats creating 
and maintaining both 16- and a 32-bit versions of the code! 

By the way, we are using VC++ 4.0 and MFC 4.0. Unfortunately, 
since Microsloth decided to kill Win32s support as of VC++ 4.2, we 
will be stuck using 4.0 for a long, long time. Is there another way to 
support Win32s and still upgrade to VC++ 4.2 (or higher)? 

WDJ: I haven’t heard of any solution; Microsoft seems to have 
rapidly dwindling interest in the problem developers face in sup¬ 


porting Windows 3.x. We’ve seen support for 16-bit development 
and even Win32s begin to erode; as you mentioned, you’re unable to 
upgrade to the latest VC++ because you need Win32s support. As 
another example, BoundsChecker is no longer updated for 16-bit 
Windows (e.g., it doesn’t work with the latest Borland compiler). It 
seems like at some point you will have to draw a line in the sand and 
cease supporting 16-bit Windows. Do you have some criteria for 
when that will happen? Perhaps when Win 16 users of your product 
drop below a certain percentage? 

DP: All future versions of the software will be Win32 versions. 
There will undoubtedly come a time when we will have to drop 
Win32s support, but I really don’t know when that will happen. It 
appears that our company may stop supporting Novell networks in 
the future, and use only Windows 95 for small networks and 
Windows NT for large networks. At that point, we will probably 
drop 16-bit Windows support. 

WDJ: With dentists as your end users, I’m guessing that making 
the UI usable has been an issue. Have you relied on any particular 
techniques to make the UI friendly, or do you just wing it like I 
always do? 

DP: There were two techniques that we followed: 

1. Keep it familiar. The software was previously DOS-based, using 
a home-grown GUI with windows, buttons, dialogs, etc. The 
look-and-feel of that product was kept simple, although honestly 
we pretty much “winged” it. So when I developed the Windows 
software, I tried to keep things looking and feeling familiar. 

2. Keep it simple. We use dental-specific vocabulary in our software 
so that end users can understand what is being asked, and so that 
their output will be understandable by other dentists. 

Part of the challenge in developing the CDR software has been 
that there is no paradigm on which to base the User Interface. The 
best we could come up with is the ‘x-ray mount,’ which allows the 
dentist to hold as many as 25 x-rays on a single “series.” 

WDJ: If you read the trade magazines, you would think that no one 
is writing Windows applications or even using C++ anymore — 
they paint a picture in which everyone is writing Java apps for the 
Internet. Exactly how, if at all, is the Internet going to affect your 
product? Whether it affects your product directly or not, is it affect¬ 
ing how you do business at all? 

DP: Our product is used in dental practices; half of these have a 
single computer, the other half have networks of up to 30 PCs. The 
users tend not to need to go “outside” their office (i.e., connect to 
the Internet) to get or send information. Therefore, I do not feel 
that the Internet will affect the product right now; however, in the 
future we will allow users to share data via the Internet. In fact, 
this current port to VC++ will allow users to email x-rays to other 
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users. This may become more tightly integrated into the product, 
thus allowing groups of dentists to share images, to hold “electron¬ 
ic study clubs,” or other group-oriented computing. Our business is 
not yet affected by the Internet, but we do have a Web page. We 
want to position ourselves as a high technology company, so we will 
make our presence known on the Internet as soon as possible. 

WDJ: You’ve already said you use VC++ and MFC. Have you, or 
would you ever, consider switching to a non-Microsoft compiler, or 
are you locked into Microsoft for the forseeable future? 

DP: We used to use Watcom C 10.6; the current development is a 
port from Watcom C using Windows 3.1 SDK to VC++/MFC. We 
seem to be locked into Microsoft for a long time, since we just spent 
about 1.5 man-years porting the code. 

WDJ: Can you point to one factor or a combination of factors that 
led you to switch from Watcom’s compiler to Microsoft? It sounds 
like it was not a trivial decision. 

DP: The one factor was the Developer Studio’s ClassWizard, I 
think. At the time, it seemed like a cool way to create the user inter¬ 
face. While Watcom supports MFC, there is no equivalent way to 
easily create MFC-based user interfaces in the Watcom IDE. We 
also wanted to have Windows 95, Win32s, and Windows NT sup¬ 
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port in our app, and it seemed that going to a Microsoft compiler 
would facilitate targeting all those platforms. 

WDJ: Do you make use of OLE at all in your product? 

DP: Not yet, but we plan to before the release of this version. 

WDJ: What parts of OLE will you try to take advantage of, and 
how will they benefit your application? 

DP: We will create an OLE server for our x-ray images, so that 
users of other programs can paste x-rays onto Dental Charts (for 
example) and then view them in CDR (our software). As with most 
uses of OLE, this will result in better integration between disparate 
software packages. 

WDJ: How important is MFC in your product? Do you mainly use 
the MFC code generated by the wizards, or do you have a number of 
your own classes derived from MFC classes? Is MFC expertise 
spread evenly around the shop, or are there one or two designated 
MFC “experts?” 

DP: We have a variety of our own classes derived from MFC class¬ 
es, mostly to get around what we consider to be quirks in MFC. 
Sometimes we had to derive classes from MFC classes to make our 
ported software act like the original version. MFC expertise is con¬ 
centrated in two “experts” in our group, but the other two develop¬ 
ers also have working knowledge of MFC. 

WDJ: Have you made use of any third-party C++ or MFC-specific 
libraries, or is your product pretty much 100 percent custom code? 




SDK Annotation #164 


TYPE: Win32 

TOPIC: EditStreamCallback 
KEYWORD: EditStreamCallback 




The return value from this function is incorrectly 
documented. The return value from the 
EditStreamCallback is interpreted as an 
SCODE - you should return 0 to indicate 
success or an error code otherwise (both while 
reading and writing). 

Reference: MSDN KB article Q136810 


Submitted by Donald Munro. 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications" 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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DP: We use some of the MFC components which come with VC++ 
(e.g., splash screen, property sheets, RTF controls), but there are no 
third-party libraries. 


particular compiler vendor (Microsoft) to put support for Win32s back 
in, but apart from that, if you could get your compiler vendor to do just 
one thing better or differently, what would it be? 


WDJ: Besides the toolset that comes with VC++, can you list any 
other programming tools you use (revision control, bug tracking, etc.)? 

DP: We use MKS Source Integrity for revision control, 
TrackRecord for bug and feature tracking, and plan to use 
MemCheck for runtime memory and API parameter checking. In 
addition, we use the CodeWright editor for source code editing. 

WDJ: Clearly, IDE vendors would rather you stayed inside their 
integrated editor, yet you’re still willing to pay for a separate edi¬ 
tor and put up with some extra hassle to use it. What is it that 
CodeWright is doing right in their product that makes you willing 
to stick with them? 

DP: I personally “grew up” on the vi editor of UNIX. CodeWright 
has a variety of editor modes, including vi, which is the one that I 
use. Furthermore, CodeWright has syntax coloring, template fill¬ 
ing, predefined and user-definable macros, and predefined and 
user-definable editing modes. None except syntax coloring is 
available in the Microsoft editor. (Note that I don’t use the user- 
definable macros or modes, but other developers in my group have 
created their own macros and even modified the CodeWright dia¬ 
log boxes to better suit their needs. I do, however, use the prede¬ 
fined macros in CodeWright.) 

WDJ: It seems to me that programmers use few tools outside of 
their compilers — why do you think that is? Are there programming 
tools you would like to see that are not currently on the market? 
What are programming tool vendors doing wrong or right? 

DP: I feel that there is generally not enough (or tight enough) inte¬ 
gration between programming tools and compilers. For example, 
we would have liked to use CodeWright as a drop-in editor to 
replace the humble editor in DeveloperStudio, but the best integra¬ 
tion we have is that when we click a button in VC to go to CW, the 
same files are loaded into CW as were in VC. This is not a useful 
feature to me, because it requires two programs to be loaded, and 
you’re forever switching back and forth. I would like to see a pro¬ 
gramming tool which integrates the best of everything: 

1. User finds and reports a bug. Product support enters bug into 
database, which assigns a bug reference number. 

2. Programmer gets report from database, identifies which modules 
are affected; database is updated. 

3. Affected modules are automatically checked out of revision 
control, and are brought up in an integrated edit/compile/debug 
environment. 

4. When programer is finished and checks modules into revision 
control, part of the revision comment (which is required) is the 
bug reference number, and the bug database is updated to reflect 
that the programmer has fixed the bug. 

The first time I saw Developer Studio, I fell in love with the abil¬ 
ity to add command handlers without typing (Classwizard), debug 
using the same environment, and debug DLLs (in the Watcom IDE, 
this is very difficult). I later realized that there is always a penalty — 
e.g., the lack of a drop-in substitute editor or decent integration with 
revision control. 

WDJ: Compiler vendors have to make some tough tradeoffs between 
adding library features, adding IDE features, improving the documen¬ 
tation, fixing bugs, and so on. Obviously, you would really like your 


DP: Faster, more efficient compiles. We currently have approxi¬ 
mately 120 . C and . cpp files in our project, and when we make a 
change to one of the main classes (e.g., the Document class), it 
takes an hour to recompile the relevant modules. I am running a 
Pentium 75 with 16Mb and Windows 95. Watcom took about nine 
minutes to compile every module in the “old” project, which was 
about 90 .C files. I find these differences in compilation times 
very frustrating, and it makes me wonder if we made a mistake in 
going to the Microsoft compiler. Furthermore, the final program is 
much (~3 times) larger than the Watcom program, not to mention 
all the MFC DLLs that have to be shipped with the app. Of course, 
I do recognize the fact that we are gaining functionality, not only 
from MFC, but from adding features to the program when we 
ported it to MFC. 

WDJ: Have you found any particular programming books to be 
truly useful in the last year or two? 

Like many Windows programmers, I learned how to program from 
Petzold’s Programming Windows. It literally changed my life.:-) □ 
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First Impressions of Recent Titles 



Systems Programming for Windows 95 
Walter Oney 
715 pages 

Microsoft Press, 1996 
$39.95, includes CD-ROM 
ISBN 1-55615-949-8 


[Editor’s note: this review was provided by 
Paula Tomlinson.] Although it contains some introductory material 
covering basic Windows 95 system level topics — such as process¬ 
es and threads — this is basically a VxD book. I’m familiar with 
some of the articles Mr. Oney has written on various DOS, 
Windows, and Windows 95 programming; he is well qualified to 
write a book on VxDs. 

This is an interesting time for device driver writers. On one 
hand, the highest-volume Windows operating system is clearly 
Windows 95. On the other hand, Windows NT is gaining momen¬ 
tum and does not support VxDs. Microsoft has announced a future 
device driver model called WDM (Win32 Driver Model) that will 
run on both Windows 95 and Windows NT, but neither Windows 95 
or Windows NT 4.0 supports WDM yet. Since WDM more closely 
resembles the Windows NT driver model, investments in writing 
VxDs won’t easily port to WDM. However, the author makes the 
case that Windows 95 will continue to be the volume platform for 
some time and will continue to support VxDs in future versions. 

Given that you’ve decided to write a VxD, I would recommend 
buying this book. There are only two other books that I’m aware of 
that cover VxDs in detail, so there’s probably room on your shelf for 
one more. One advantage this author’s book has over the other 
books is purely timing; since this book was more recently released, 
it covers some of the new Windows 95 VxD features (primarily 
Plug-and-Play support). The book includes a methodical and 
detailed description of what VxDs are and how they interact with 
the operating system. Since the Windows 95 DDK is really just a 
reference for system services available to VxDs, any book that lays 
out the material in a sequential, tutorial style is a vast improvement. 
There are additional specific sections on I/O programming (basic 
I/O, DMA, and memory-mapped programming techniques, as well 
as virtualization of these resources), communications drivers (the 


Got an opinion about these or other programming books? Send them to 
70302.2566@compuserve.com. You can order any of the books that appear 
in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing 
(913) 841-2624, or sending email to orders@mfi.com. If using fax or email, 
send the book title, author, and publisher along with your MasterCard, Visa, 
or American Express number, expiration date, and phone number. 

To submit books for review, send them to: Ron Burk, 13846 NE 60th Way, #120, 
Redmond, WA 98052-4542. Please do not send press releases to this address. 


Ron Burk 

Books in Brief 


VCOMM interface), block device drivers (the IOS interfac 
the installable file system interface (IFS). 

Since the book is over 700 pages, the author decided 
include source code listings in much of the main body of tl 
(they are included on the accompanying CD-ROM). While 
relish the idea of hefting a 1,000-page book, I miss being able to see 
source code examples as the topics are being explained. The CD- 
ROM does contain a fair amount of sample code. The Plug-and- 
Play chapter in particular has a fairly detailed sample set of drivers 
that includes a bus enumerator driver, a resource arbitrator, a prop¬ 
erty page provider, and an INF file for installing the drivers. The 
book contains an official Microsoft License Agreement that 
describes how you are allowed to use the sample source code. In 
essence, you can use and distribute the sample source code without 
royalties. You can’t use Microsoft’s or the author’s name to market 
any products that use the sample source, but you do have to include 
any copyrights that appear on the sample sources on your product 
label and as part of your sign-on screen. In addition to the sample 
code, I found the author’s personal annotations to the Windows 95 
DDK help file a nice addition. 

Beginning Delphi 2.0 
Peter Wright 
495 pages, includes disk 
Wrox Press, 1996 
$36.95 

ISBN 1-874416-74-5 

[Editor’s note: This review was provided by 
George Tylutki.] This is another in Wrox’s Beginning series; Wright 
has also written Beginner’s Visual Basic 4.0. The topics covered 
include the IDE, components, MDI, Object Pascal, Object-Oriented 
Programming, graphics, exceptions and the integrated debugger, 
database programming, OLE, CGI, the Win API, and multimedia. 

Although Wright is a competent programmer, the coverage of 
the material is inconsistent and sometimes superficial, and the writ¬ 
ing is awful. This is probably due to his inability to decide who his 
audience is. On page 1, he says the book “assumes no prior knowl¬ 
edge of computer programming,” but on page 240, his readers may 
have debugged programs: “We’ve all been there; you run the pro¬ 
gram, see if it does what it’s supposed to do, and if it does you go 
[sic] ‘OK . . . that’s done’ and move on. WRONG! If that’s the way 
you work, I’ve got a big shock for you” (notice the tone). On the 
next page, the reader may even have worked on large projects: “If 
you’ve ever worked in a development team.” Soon the reader is a 
novice again: “If you have used other Windows programs.” Later, 
they’re knowledgeable enough to answer this question: “Do you 
really care about stuff like Allocation Granularity!?” In the next 
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chapter, he addresses a different set of readers: “As you probably 
know, Windows is a multitasking operating system.” 

Material must be selected and prepared for a target audience. 
Wright covers many of the basics, such as adding, resizing, and 
moving components in the IDE, and he defines terms like “case sen¬ 
sitive” for the reader. He also provides 390 screen shots and illustra¬ 
tions. But many topics are not handled as thoroughly or consistent¬ 
ly as they should be. Only 5 pages, including 7 screen shots, are 
devoted to the common dialog boxes. He has beginners add compo¬ 
nents to the palette without backing up the VCL first. No mention is 
made of downto in the section on for loops. Only a few of the com¬ 
piler and linker (and none of the debugger) options are covered. 
DLLs are not explained. He points out that procedures and func¬ 
tions can take var and const parameters, but not that they can take 
zero parameters. His illustration of a function is not of a generic 
Pascal function but of a private class method. His discussion of 
arrays jumps from a simple 6-element array to a 12x19 array which 
holds the results of the function sin(X)/X, which are displayed in a 
grid and charted using an OCX (but no screen shot here). He says 
that he finds aliases (“nicknames”) are “more trouble than they’re 
worth,” but 40 pages later shows how useful they are. 

The readers must have Excel installed to run the OLE exam¬ 
ples. In Chapter 9, he explains the significance of the relational 
database model and proceeds to construct a one-table example. 
The discussion of exceptions is delayed until Chapter 7, and he 
doesn’t use them consistently in his code. There are a number of 
factual errors. The OOP chapter must be read twice to sort things 
out: “Create [a constructor] is a method that Delphi automatically 
inherits from TObject.” 

At the end of the book, Wright recommends Code Complete, 
Writing Solid Code (C-based), Debugging The Development 
Process, MS Test, Bounds Checker, and two other WROX books 




SDK Annotation #165 


TYPE: Win16 

TOPIC: GetNextDIgGroupItem 
KEYWORD: GetNextDIgGroupItem 

The Win16 SDK fails to mention that this 
function ignores controls that are part of the 
group but are disabled. The documentation has 
been corrected in Win32. 

If you use MFC, check out Annotation #166 
(DDX_Radio) for this bug’s repercussions. 

Get the entire set of annotations from www. wdj. com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications” 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 



(one is another beginner’s book). The VCL source code, Turbo 
Debugger, and an intermediate Delphi book might be better pur¬ 
chases. Instead of CGI and OLE, this “beginner’s guide” might have 
covered printing, displaying text, and file handling. 

The book is badly written and edited. There are 540 run-on sen¬ 
tences and numerous grammatical, typographical, and usage errors. 
There is too much meaningless talk: “Adding multimedia elements 
to your applications [the latest reference is to an accounts system] 
can bring them to life in a way that many would never dream possi¬ 
ble”; “with Delphi 2.0 we now have a product that quite literally 
blows the competition out of the water”; “you’re definitely on your 
way towards Delphi Guru status.” (How does your dictionary 
define “literally” and “guru”?) Silly personification abounds: the 
MCI API interface “just ignores you, kind of sulks!”; an 
EZeroDi vi de error “is greeted with horror by Delphi.” The sloppi¬ 
ness of the writing is distracting: examples of Internet sites provid¬ 
ing a degree of interaction “include the multitude of search engines 
provided by people like Yahoo and AltaVista”; “before you can cre¬ 
ate a variable, you must do a few things before you’re ready to 
rumble: Define your data type; Create an instance of the data type; 
Initialize it.” He insults his readers: “while using the API may scare 
VB and C programmers, you’ve got a friend in Delphi”; “if you’re 
really lazy, you can just grab this from the examples on the disk”; if 
“you have the screaming heebie-jeebies about all this abstract tech- 
no-babble.” The writing is also repetitious and cliched and there 
are too many exclamation points. 

The disk contains a 507Kb file that installs the source code. I 
found no copyrights in the code, although the “software product” is 
copyrighted and licensed for use on one computer. The index is weak. 

Most beginners will find extracting information from Beginning 
Delphi 2.0 difficult. If readers make it to the end, they’ll come away 
somewhat confused and have inflated opinions of their abilities — 
“you’re going to learn everything there is to know about creating 
and dealing with objects in your own code” — but they will gain a 
modicum of knowledge. They will have to read at least one more 
book to begin doing real programming. So why not buy a better 
introductory book in the first place? Delphi 2 Programming 
Explorer is written in a friendly, conversational manner and covers 
about the same amount of material as Wright’s does. Delphi 2 
Unleashed is nearly comprehensive and well-written (although 
wordy). Although more expensive, both are better books than 
Beginning Delphi 2.0. 



Delphi 2 Developers’ Solutions 
Nathan Wallace and Steve Tendon 
873 pages, includes CD 
Waite Group, 1996 
$59.99 

ISBN 1-57169-071-9 


[Editor’s note: This review was provided by 
George Tylutki.] This book gives “advanced programmers in-depth 
tutorials backed by both detailed 32- and 16-bit source code.” The 
reader should be “completely familiar both with the Delphi 1.0 and 
2.0 environments and the Object Pascal language.” 

There are 80 How-To’s in 11 chapters: utilities, files and directo¬ 
ries, keyboard and mouse, printers and printing, help files, graphics, 
database programming (two chapters), and programming for the 
Internet (three chapters). Among the many topics covered are: 
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screen savers; a NeXT-style taskbars; recursively copying, moving, 
and deleting files; animated and color cursors for Win 3.1; drag- 
and-drop; print preview and print-to-file; preserving information 
when creating thumbnail images; handling bitmaps larger than 
64Kb with Delphi 1.0; using in-memory database tables; and han¬ 
dling client/server multiple transactions. Each How-To is composed 
of several sections: a statement of the problem; an overview of the 
techniques used to solve it; step-by-step instructions with code; an 
explanation of How It Works; and additional Comments. The last 
two sections combined with the many comments in the code pro¬ 
vide thorough explanations of most solutions, although a few would 
benefit from more explication. 

Solutions often build on earlier solutions. For example, in the 
first Internet How-To, a Winsock object is created (the Internet com¬ 
ponents shipped with the latest Delphi version aren’t used); subse¬ 
quent solutions in that chapter address connecting to an FTP server, 
uploading and downloading files, and so on. Two large sophisticat¬ 
ed apps are built this way: a graphical File Center 
(“UNIX/Windows 95-style File Manager”) and an Internet 
Command Center (FTP, NNTP, POP3/SMTP, UUCode/UUDecode, 
and MIME, but not HTTP). The authors also emphasize reuse by 
encapsulating many solutions into ready-to-use components. 

The solutions are compatible with Delphi 1.0 and 2.0, unless 
designed to overcome limitations in 16-bit Windows (animated 
and color cursors, for example). Whenever appropriate, the 
authors discuss differences between 1.0 and 2.0 implementations 
and note bugs and deficiencies in Delphi, Win 95, the Image 
Editor, BDE, and Winsock. 

Much of the book is composed of well-written Pascal code. The 
formatting, comments, and use of descriptive identifiers make it 
easy to understand. The authors admit that they opted for clarity 
over efficiency when a choice had to be made. The software license 
is standard (one copy on a single computer, etc.) However, none of 
the code carries a copyright and this book (“Developers’ 
Solutions”) makes little sense unless readers (“the professional 
developer”) are free to use the code and components in their appli¬ 
cations (which the authors urge). The index is only fair. The CD 
contains: the book’s code; additional code, units and components; 
shareware and freeware units, experts and components; commer¬ 
cial demos; and more. The installation program offers many choic¬ 
es for partial installation. 

The book shifted focus while it was being written because of 
the Win 95 and Delphi 2.0 releases. This may account for several 
problems. First, some of the solutions are unpolished. The first 
How-To, a screen saver, may do nothing except blank the screen 
because when it initially positions the user’s designated bitmap, it 
doesn’t take into account the bitmap’s size. This can result in off¬ 
screen x and y coordinates. The Graphical File Manager can 
recursively search for files. Although users may choose a drive 
and directory and enter a file specification (e.g., “*.txt”), the 
search routine always uses the current drive and directory. 
Neither of these problems is difficult to fix. Apparently, the pub¬ 
lication deadline prevented the authors from doing so and from 
“proofreading” the code (there are numerous declared but unused 
variables). 

Second, the authors admit that at least one How-To (9.8) has a 
bug; they promise to provide a fix on the CD, but a note there indi¬ 
cates it can be found on a Web site. Other material, including a Web 
browser, also didn’t make it onto the CD. 


Third, the book needs better editing. The authors don’t always 
address the readers as experienced programmers who are calling on 
them for information: does any professional developer believe that 
reading a book will make him or her “a member of the ‘black art’ 
programming fraternity” or “a Delphi image guru”? Frequently, the 
authors sound like salesmen: a How-To “explains all the details” of 
creating an Interbase database; with the BDE, you can “solve any 
database-related problem you can imagine.” Sometimes they sound 
like adolescents: “cool trick,” “just like in Hollyweird,” “Smokin’, 
Dude!”. The humor is weak — “the ‘bit bucket’ (that little door in 
the side of your computer, which the little elves come to clean out 
every night . . .)” — and sometimes shows a lack of sensitivity — 
“Darned clever, these Pascal-ese!”. 

Programmers at all levels (not just Delphi developers) may find 
this book useful. It provides an excellent means of increasing 
knowledge and programming skills through the study of well-writ- 
ten, sophisticated code designed to provide solutions to specific, 
sometimes complex problems (with the authors’ comments at 
hand). At the same time, it is a practical book/software package: 
depending on your needs, the information in any chapter or any sin¬ 
gle component on the CD may be worth many times the purchase 
price. However, you should be prepared to spend some time online 
(due to problems noted above). It’s deplorable that publishing dead¬ 
lines result in books that must be supplemented by online additions 
and corrections. If this were a software-only package, I’d praise it 
and suggest waiting for version 2.0. But it isn’t. So give Delphi 2 
Developers’ Solutions serious consideration. 


HyperTerp 


DELPHI 

I^JCU/VCE 


• A true Delphi VCL ■ no VBXs, DLLs or other “additional” files 

• Easy to use - Drag&Drop on the form, set 3 events handlers and go! 

• Plug-in architecture for user and 3rd-party extension libreries 

• 1/0 and error events simplify integration with your application 

• Registration and extension events to add app. specific functionality 
Small Footprint Object-Based Syntax 16 & 32 Bit No Royalty 

HyperTerp/Std - $249 l Hl,pe ' Te,p ™ y:e ' 7 ^ ^ 

Compiled Delphi units (.DCU) 

HyperTerp/Pro - $395 

Complete source code 


iHyperAc 


1 OrAdvariceLine [^~ -*■ 

OriBreakPoint HyperT erpBreakPoint 

OnEnterProc 

OnError Hyper! erpError 

OnExitProc 

OnLoopCallback HyperT erpLoopCallback. 
OnRead HyperTerpRead 

0 nRegisterProcs Hyper! erpR egisterProcs 
QnSrcLineEnter HyperTerpSrcLirteEnter 
OnSrcLineRead 


Phone:(515)987-2910 
Fax: (515) 987-2909 
e-Mail: rhalevi@hyperact.com 

http://www.hyperact.com 
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Encyclopedia of Graphics File Formats, 2nd Edition 


by James D. Murray and William vanRvper, O ’Reilly & Associates, 
Inc., 1,116pages, $79.95, ISBN 1-56592-161-5 

An expensive but thorough compendium of graphics file formats. 
The book divides the labor between physical page and enclosed 
CD-ROM by printing structured summaries of each file format in 
the book and including more detailed specifications and examples 
on the CD-ROM. It’s the first reference to reach for if you have to 
tinker with graphics files directly. 

The Revolutionary Guide to MFC 4 Programming with Visual 
C++ 

by Mike Blaszczak, WROX Press, 871 pages, $49.95, 

ISBN 1-874416-92-3 

Much improved over the first edition, this book is one of the few 
MFC titles worth having. The common control section is espe¬ 
cially strong, but there’s plenty of experience-based information 
throughout. 


Books Received 


Kimball. The Data Warehouse Toolkit. Wiley. 388 pages. $44.95 
(includes CD-ROM). ISBN 0-471-15337-0. A guide to data 
warehousing, actually making the data in your company’s 
databases serve the information needs of the employees. Lots 
of case studies. 


Orfali, Harkey, and Edwards. The Essential Client/Server Survival 
Guide, 2nd Edition. 676 pages. $32.95. ISBN 0-471-15325-7. 
Your casual, high-level guide to the rich jargon of the 
client/server field. Lots of new material, including an attempt to 
keep up with Java and Web developments. 

Orfali, Harkey, and Edwards. The Essential Distributed Objects 
Survival Guide, 2nd Edition. 676 pages. $29.95. ISBN 0471- 
12993-3. High-level, but thorough introductions to CORBA, 
OpenDoc, OLE, and more. Not a bad place to start learning how 
OLE fits into the grand scheme of things. 

Woram. The Windows 95 Registry. 350 pages. $24.95. ISBN 1- 
55828- 494-X. The subtitle is “A Survival Guide for Users,” 
but only power users and programmers will dare enter here. 
Lots of obscure settings documented, though not always in 
enough detail to help. 

Volkerding, Reichard, Johnson. Linux Configuration and 
Installation. 522 pages. $39.95. ISBN 1-55828-492-3. "... lets 
you run Linux today ... all you need is a PC, a CD-ROM drive, 
and this book.” □ 


Bug Management a Pest? 
Give PR-Tracker a Test! 

Problem Tracking 
for Windows* 

Windows ^ and 
Windows. Ht 

• Records bugs as 
problem reports in a network 
database 

• Supports simultaneous access by 
multiple users 

• Features classification, assignment, sorting, 
searching and estimation 

• Supports project by project data entry and 

Download PR-Tracker for evaluation 
http://www.halcyon.com/softwise/prtrack.zip 

CompuServe: CaseForum: prtrack.zip 

By Softwise softwise@halcyon.com 

http:// www. halcyon, co m/softwi se/p rt ra c ke r. ht m I 
phone: 206-513-0415 fax: 206-513-0516 
o Request Reader Service #144 o 






SDK Annotation #166 


TYPE: MFC 
TOPIC: DDX_Radio 
KEYWORD: DDX_Radio 

DDX_Radio internally uses 
GetNextDIgGroupItem (see SDK annotation 
#165) and therefore ignores disabled radio¬ 
buttons. This could causes 2 radio buttons in 
the same group to be selected, if a disabled 
radio-button is selected. Generally, you are 
better off not using this function if you are 
going to enable/disable radio-buttons. Use the 
Windows SDK functions instead. This applies 
to MFC 1.x and 2.x. 

Reference: MSDN KB Q114980 

Get the entire set of annotations from www.wdj.com or 
CompuServe (file sdkann.zip in section 7 “R&D Publications’’ 
of forum SDFORUM). Contribute your own annotations via 
email to 70302.2566@compuserve.com (indicate which topic 
in which help file you are annotating). 
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If you discover a bug in the latest version of 
your favorite compiler, email it to us at 
wdletter@mfi.com. Please specify which ver¬ 
sion of your compiler you are using and include a tiny 
program that demonstrates the problem, along with the 
exact command-line options needed to compile it. 



Mark Nelson 

Bug++ of the Month 



Regular readers of this column know that I’m no fan of floating 
point numbers. The rare situations that require me to use a f 1 oat or 
a double in a C++ program always make me nervous and edgy. I 
already have a huge range of mistakes that I can make using just 
integers — it doesn’t really seem like a good idea to expand the 
field unless absolutely necessary. 

Of course, compiler writers don't have the luxury of ignoring 
floating point numbers. While it’s true that many serious number 
crunchers learned their trade in the golden age of FORTRAN, it 
seems likely that the next generation of astronomers, physicists, 
and mechanical engineers will be writing much of their code in C 
or C++. 

Tangential Thinking 

This month’s bug was posted in a public Microsoft support 
forum by Jeff Stong. Jeff ran into a case where Microsoft’s 32-bit 
compiler optimized its way into trouble. My stripped down program 
that demonstrates the problem is in bug0197. cpp (Listing 1). The 
subroutine CalcO performs several computations, but the one of 
interest here is atan2(), which calculates the arc tangent of one 
number divided by another. 

My program calls atan2() with arguments alpha and beta, 
which are both computed inside CalcO. By judicious parameter 
selection, I ensure that alpha and beta will both be 1, meaning 
atan2( ) is being asked to calculate the arctangent of 1.0. A journey 
down memory lane to your trigonometry might prompt a hazy rec¬ 
ollection that atan2() should yield a result of 45 degrees in this 
case. In fact, the program does yield this answer when compiled 
with all optimization turned off. But when compiled with the /Ox 
option asking for maximum optimization, the disappointing output 
looks like this: 

theta = 0.955317, or 54.7357 degrees 
theta should be 0.785398, or 45 degrees 

It seems that the compiler ran into a snag or two when allocating 
registers on the floating point stack. 


mn™ Can't find that bug from a past issue? The Windows Developer's 
LyS Journal CD-ROM with full search capabilities is now available. 
Yjtmk See page 16 for more information. 


Mark Nelson is a programmer for Addisoft Consulting, Inc. in Dallas, Texas. 
Mark is the author o/The C++ Programmer's Guide to the Standard Template 
Library, from IDG Books, as well as The Data Compression Book, from M&T 
Books. You can reach Mark on the Web at http://web2.airmail.net/markn. 


Response from Redmond 

Steve Ross from Microsoft responded quickly to this bug report: 

This is, indeed, a bug in our 4.x compiler having to do with the float¬ 
ing-point stack. If you use -Op (improve floating-point consistency), 
you will not encounter the bug. This problem will be fixed in a future 
version of Visual C++ such that you do not have to use the -Op 
switch. 

Good advice, although some purists might find fault with the need 
for such a compiler switch! 

Thanks to Jeff for reporting this bug — he is this month’s recip¬ 
ient of the WDJ t-shirt. Send your C++ bug reports to me at well et - 
ter@mfi . com. I look forward to hearing from you! □ 


Listing 1: The VC++ floating-point bug 


II 

II This program demonstrates a code generation bug 
// in Visual C++ 4.1. The program calculates 
// the arc tangent of 1, which should be 45 degrees. 

// Compiling this console mode program with /Od as an 
// option gives the correct result for theta. 

// Compiling with /Ox causes the program to calculate 
// theta as something in the neighborhood of 54 degrees. 

II 

(/include <iostream.h> 

(/include <math.h> 

double theta; 

void Calc( int &x, int &y ) 

1 

double alpha - x - 5; 
double beta - y - 7; 

double A - sqrt( ( alpha * alpha ) + ( beta * beta ) ); 
theta - atanZC beta, alpha ); 

double phi - atan2( 5.0, 3.0 ); 

x - A * cost theta ); 
y - A * sint theta ); 

1 

maint) 

1 

int x - 6; 
int y - 8; 

Calct x, y ); 

cout « "theta - " « theta 
« ", or " 

« ( 180.0 * theta / 3.14159 ) 

« " degrees\n"; 

cout « "theta should be 0.785398, or 45 degrees\n”; 
return 1; 

1 

//End of File 
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New Products 


Send your press release to Miller Freeman, Inc., 1601 W. 23rd St. 
Suite 200, Lawrence, KS 66046; fax 913-841-2624; 
wdletter@mfi.com. 


Willows Toolkit Now Supports QNX 

Willows Software, Inc. has released a version of the Willows 
Toolkit that supports QNX. Windows applications ported to QNX 
will inherit QNX features such as improved realtime performance 
and built-in network fault-tolerance. 

QNX’s built-in networking allows users and technical support 
people to view and control Windows applications running on 
remote PCs, without additional software. Also, QNX enables 
Windows applications to run on diskless network computers. 

The Willows Toolkit library is based on a single set of source 
code that can be compiled and linked for the target environment, 
allowing cross-platform applications to run at native speeds. Other 
features allow for use of third party components without vendor 
source code. The Windows Toolkit supports MFC and Borland's 
OWL, and is royalty-free. 

The Willows Toolkit for QNX costs $1,995 for one node and 
$3,980 for four nodes, and is available from QNX. For more informa¬ 
tion, contact QNX Software Systems Ltd., 175 Terence Matthews 
Crescent, Kanata, Ontario K2M 1W8 Canada; 800-676-0566 or 
613-591-0931; fax 613-591-3579; info@qnx.com; www.qnx.com. 

For information on the Willows Toolkit for other platforms, contact 
Willows Software, Inc., 12950 Saratoga Ave., Suite A, Saratoga, CA 
95070; 408-777-1820; fax 408-777-1827; info@willows.com; 
www. willows, com. 

Rogue Wave Announces Threads.h++ 1.0 

Rogue Wave Software, Inc. has announced Threads.h++ 1.0, a 
C++ class library that encapsulates multithreading mechanisms 
such as C++ objects. This simplifies development of applications 
that can take advantage of idle periods during file and network oper¬ 
ations, or efficiently distribute program execution over additional 
processors in a multiprocessor system. 

Threads.h++ 1.0 provides a platform-independent programming 
model for writing multithreaded applications. This hides the differ¬ 
ences between supported platforms and offers a common set of 
portable, object-oriented mechanisms. Once written, an application 
can be recompiled to run on a variety of major platforms, including 
Windows 95, NT, Solaris, HP-UX. AIX, and OS/2. When portabili¬ 
ty is not a required, developers can optimize application perfor¬ 
mance by using multithreading capabilities and controls specific to 
a target platform. 


Threads.h++ 1.0 costs $695 for a single-user license and $345 for a 
one-year upgrade and support contract. Site licenses are also available. 
For more information, contact Rogue Wave Software, 260 S Vf 
Madison Ave., P.O. Box 2328, Corvallis, OR 97339; 800-487-3217 or 
503-754-3010; fax 503-757-6650; websales@roguewave.com; 
www.roguewave.com. 

SQA Ships SQA Suite for Delphi 

SQA, Inc. has shipped a special preview evaluation version of 
SQA Suite for Delphi, a new version of SQA Suite that supports 
Delphi Client/Server Suite 2.01, Borland’s 32-bit visual compo¬ 
nent-based rapid application development (RAD) tool for Windows 
NT and Windows 95. 

SQA Suite for Delphi takes advantage of Borland’s Open Tools 
API. This object-level integration allows users of SQA Suite to 
create reliable, position-independent test scripts for Delphi appli¬ 
cations, and automatically test the properties and data of objects in 
32-bit Delphi applications, including over 30 Delphi Visual 
Component Library (VCL) objects, as well as ActiveX and OLE 
controls. In addition, SQA Suite for Delphi provides integrated 
load, stress, and multi-user testing of Delphi applications in LAN 
and WAN environments, along with integrated test management 
and defect tracking. 

For pricing and additional information, contact SQA, Inc., 
One Burlington Woods, Burlington, MA 01803; 
800-228-9922 or 617-229-3500; fax 617-229-3780; www.sqa.com. 

Star Base Releases StarTeam 2.0 

StarBase Corporation has released StarTeam 2.0. StarTeam 
2.0 provides tools for promoting collaboration and configuration 
management among application developers on Windows NT and 
Windows 95 platforms. In addition, the version control and col¬ 
laboration features of StarTeam allow Webmasters to better man¬ 
age Web sites, especially during updates and site construction. 
StarTeam includes a full suite of tools allowing Webmasters to 
provide management of sites. 

The StarTeam WebConnect server allows developers and team 
leaders to participate in the application development process, 
regardless of their location. WebConnect also allows unlimited 
access to StarTeam projects without the need for additional servers 
or StarTeam clients. 

StarTeam 2.0 Workstation costs $549; quantity discounts are 
available. The WebConnect component of StarTeam costs $949 per 
server; the StarTeam Server is also $949. For more information, 
contact StarBase Corporation, 18872 MacArthur Blvd., Suite 
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300, Irvine, CA 92715; 888-782-7700; fax 714-442-4404; 
sales@starbasecorp.com; www.starbasecorp.com. 

Black Ice’s Fax C++ Available for OCX 

Black Ice Software, Inc. has announced availability of Fax C++ 
OCX, a fax toolkit that supports GammaLink and Brooktrout 
Boards. The Fax C++ OCX includes support for Class 1, Class 2, 
and Class 2.0 fax modems. Combined with other Black Ice products 
such as the Generic Printer Driver and Imaging Libraries, software 
developers can develop color and monochrome fax applications or 
fax-enable existing applications. 

The Fax C++ OCX is designed to enable developers and end users 
to combine fax, voice, and data. Features include TWAIN support, 
caller ID. subaddressing, Group 4 faxing, polling, built-in fax protocol 
analyzer, and phonebook. It supports Class 1 software error correction 
and binary fde transfer (BFT) and handles a wide variety of image for¬ 
mats, including JPEG, La*b* Color Space, comprehensive 
TIFF/CCJT G3, PCX, DCX, and compressed and uncompressed 
Microsoft Device Independent Bitmaps (DIBs). It also supports send 
and receive queue management, dynamic configuration of faxing 
device, and communication port control. It comes with an extensive 
sample program with source. 

The Fax C++ OCX costs $1,500 and includes the Fax C++ for 
NT. For more information, contact Black Ice Software, Inc., 292 
Route 101, Amherst, NH 03031; 603-673-1019; fax 603-672-4112; 
blackice@mv.mv.com. 

Sax Software Ships New Version of Webster 
Control 

Sax Software is now shipping version 2.0 of Sax Webster 
Control, the company’s embeddable web-browsing component. Sax 
Webster Control 2.0 lets developers add web browsing to their pro¬ 
grams by dropping the control on a form. 

Sax Webster Control lets users make selections from predefined 
menus, enter keywords for searching, send information to a server, 
and receive automatic updates. The Webster’s filter feature can be 
set to scan the contents of a page before it is displayed to users, giv¬ 
ing developers control over what information users are able to 
access. For users who don’t have an Internet connection or who 
want to minimize their online time, Sax Webster Control offers off¬ 
line browsing from users’ hard drives or CD-ROMs. 

The Webster Control includes table support and supports HTML 
3.0 from the LAN, local files, CD-ROM database records, the Web, or 
other data sources. It includes a toolbar, a status bar, an animated icon, 
and offers a choice of fonts and colors. No coding is required to install 
Sax Webster Control because it uses the system's TCP/IP stack. 

Sax Webster Control costs $149. For more information, contact 
Sax Software, 950 Patterson St., Eugene, OR 97401; 800-645-3729 
or 541-344-2235; fax 541-344-2459; info@saxsoft.com; 
www.saxsoft.com. 

UnderWare Announces Track Record 3.0 

UnderWare, Inc., has released Track Record version 3.0, a 
Windows software development tool for tracking bugs, features, 
releases, and other details associated with software projects. 


Track Record 3.0’s integration with popular version control soft¬ 
ware, including Microsoft Visual SourceSafe, helps workgroups 
stay connected and on top of their projects. Users can check files in 
and out. keep histories of files and version numbers associated with 
each bug report or feature, and synchronize Track Record releases 
with releases in their version control system. 

Track Record 3.0 includes Track Record AutoAlert, an optional 
email notification module. With AutoAlert. users can automatically 
email team members when data in their Track Record database 
changes. Email notification is based on Track Record’s query tech¬ 
nology. AutoAlert is sold separately and works with any MAPI- 
compliant mail system. 

Track Record 3.0 costs $195 per user. Concurrent use licenses 
are available at additional cost. A fully integrated client/server ver¬ 
sion is also available. For more information, contact UnderWare, 
Inc., 321 Columbus Ave., Boston, MA 02116; 800-343-7308 or 
617-267-9743; fax 617-424-1839; www.uw.com. 

Evergreen Software Tools Ships EasyER 1.1 

Evergreen Software Tools, Inc. has announced the availability 
of EasyER 1.1, an upgrade to the company’s data modeling/data- 
base design tool. EasyER focuses primarily on the modeling and 
design of desktop and client/server databases and applications 
while supporting popular object-oriented methods, databases, and 
application development tools. EasyER is not a replacement for or 
an upgrade to the company’s EasyCASE Professional product that 
supports process, data, and event modeling using traditional, 
structured methods. 

EasyER 1.1 now includes the Sybase SQL Anywhere 5.0 
database engine and its ODBC 2 driver. This provides the end 
user with a scaleable SQL database solution for workgroups of 
any size. 

The EasyER 1.1 upgrade is available at no cost through the 
end of 1996 to all registered EasyER version l.Ox users. To 
receive the upgrade, contact ESTI directly or download it from 
the Web (www.esti.com), FTP (ftp://ftp.esti.com directory 
public/updates/erl 10), or CompuServe (GO SDFORUM, 
EasyCASE library #17). For more information, contact Evergreen 
Software Tools, Inc., 15444 N.E. 95th St., Suite 244, Redmond, 
WA 98052; 800-929-5194 or 206-881-5149; fax 206-883-7676; 
www.esti.com. 

DFL Software Ships vl.41 of Light Lib Products 

DFL Software Inc. has released upgrades of Light Lib Images 
and Light Lib Business, and two new products. Light Lib Magic 
Menus and Light Lib Multimedia 32-bit OCX. 

Light Lib Images vl.41 now incorporates native TWAIN support 
which enables direct access to TWAIN devices without the need to 
display third-party dialog boxes. Also new in this release is the 
annotation feature that allows users to add simple vector shapes, 
lines, and text to their images. Other enhancements include reduced 
storage and retrieval times, accelerated zooming, multi-page TIF 
capabilities, and enriched help files. 

Light Lib Business now offers “fly-over” support. Stop the 
mouse pointer on a graph element and data information is immedi¬ 
ately displayed. All fly-over delay times and display times are 
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developer specified. Other enhancements include reduced storage 
and retrieval times, accelerated zooming, multi-page T1F capabili¬ 
ties, and enriched help files. 

Light Lib Magic Menus, DFL’s new VCL, offers Delphi devel¬ 
opers an alternative to the standard Windows menuing system. With 
Light Lib Magic Menus. Delphi developers can enhance their appli¬ 
cations by adding background images, textures, bitmap menu items, 
and tool button palettes. 

Light Lib Multimedia, DFL’s new 32-bit OCX, is a multimedia 
handling tool that offers optimized database storage, drag-and-drop 
development methods, and the a 32-bit OCX control. Light Lib 
Multimedia also provides native language support for Visual C++ 
and CA-Visual Objects. 

For pricing and additional information, contact DFL Software 
Inc., 55 Eglinton Ave. E., Suite 208, Toronto, Ontario M4P IG8 
Canada; 416-487-2660; fax 416-487-3656; BBS 416-487-4041; 
CompuServe GO DFLSW; bloesgenedfl.com; www.dfl.com. 


BASIS International Announces 32-Bit BASIS 
ODBC Driver 

BASIS International, Ltd. has announced its new 32-bit BASIS 
ODBC Driver, a Business BASIC connectivity tool that provides open 
access with client/server capabilities. Using a standard API, the BASIS 
ODBC driver provides a layer of interactivity between Windows appli¬ 
cations such as spreadsheets, report writers, charting tools, and a vari¬ 
ety of PRO/5 and BBx databases. This functionality lets the program¬ 
mer send SQL queries from a favorite productivity tool to the existing 
PRO/5 or BBx data source, manipulate the data in their applications, 
and then send the changes back to the data source. In addition, the 
BASIS ODBC Driver comes client/server ready. 

The BASIS ODBC Driver costs $150; quantity discounts are avail¬ 
able. For more information, contact BASIS International Ltd., 5901 
Jefferson Street NE, Albuquerque, NM 87109-3432; 505-345-5232; 
fax 505-345-5082; CompuServe 76702,1440; info@basis.com; 
www.basis.com. 

ObjectSpace, Inc. Releases C++ Class Libraries 

ObjectSpace, Inc. has released the second generation of its C++ 
Component Series including upgrades of both the 
Systems<ToolKit> and STL<ToolKit> products. Version 2 of the 
C++ Component Series consists of 10 C++ class libraries including 
the ANSI/ISO Standard C++ Library. 

Version 2 of the C++ Component Series includes 10 libraries, 
providing features such as a portable implementation of the 
Standard C++ Library and libraries for systems programming and 
Web development. All libraries are portable across popular hard¬ 
ware platforms, operating systems, and compilers, and are safe for 
use in multithreaded environments. 

For pricing and additional information, contact ObjectSpace, Inc., 
14881 Quorum Dr., Suite 400, Dallas, TX 75240; 214-934-2496; fax 
214-663-9099; scarroll@objectspace.com; www.objectspace.com. 

Indigo Rose Ships Setup Factory 4.0 

Indigo Rose Corporation has released Setup Factory 4.0 for 
Windows. Setup Factory 4.0 has been redesigned to take advantage 


of the new features in Windows 95/NT such as long filenames and 
setup animation. Setup Factory 4.0 is a 32-bit application, but can 
build both 16- and 32-bit setups. 

New features include a wizard type install, selective install capa¬ 
bility, uninstall, registry, .ini file, config.sys and autoexec.bat 
editing, setup expiration dates, password/serial number checking, 
collecting information from the user, installing files to any location, 
creating shortcuts, icons and groups, multilingual support, and cus¬ 
tomizable screens and messages. 

Setup Factory 4.0 costs $229.95. A fully functional evaluation 
version can be downloaded from www.IndigoRose.mb.ca/indigo. 
For more information, contact Indigo Rose Corporation, P.O. Box 
2159, Winnipeg, Manitoba, Canada R3C 3R5; 800-665-9668 or 
204-668-8180; fax 204-661-6904; BBS: 204-661-3044; 
www.mbnet.mb.ca/indigo/. 

DataViews 9.7 Brings Leading DDVT to 
Windows NT 

DataViews Corporation has released its dynamic data visual¬ 
ization development tool (DDVT), DataViews on the Windows 
NT platform. As a DDVT, DataViews 9.7 manages raw data and 
transforms it into intuitive graphical representations. It enables 
users to build fully animated interfaces for visualizing, analyzing, 
and regulating realtime industrial, telecommunication, and scien¬ 
tific processes. The DataViews graphics currently monitor and 
control a broad range of mission-critical environments, including 
global telephone networks, power distribution systems, sensitive 
Department of Defense installations, public transportation facili¬ 
ties, civilian and military satellites, air traffic networks, simula¬ 
tion systems, and manufacturing environments. In addition, 
DataViews 9.7 provides a true Multiple Document Interface 
(MDI), allowing users to keep multiple views of DataViews doc¬ 
uments open simultaneously. 

Introductory pricing for DataViews 9.7 for Windows NT starts 
at $5,000. OEM and volume discounts apply. Platform support for 
DataViews 9.7 includes Windows NT with Microsoft’s Visual C++ 
compiler. Training and development support services are also 
available. Cross-platform versions of DataViews 9.7 support HP. 
SUN, SGI, IBM, and Digital. For more information, contact 
DataViews Corporation, 47 Pleasant St., Northampton, MA 
01060; 413-586-4144; fax 413-586-3805; info@dvcorp.com; 
www.dvcorp.com. 

InstallShield Introduces InstallShield Express 
Professional and DemoShieldS 

InstallShield Corporation has released InstallShield Express 
Professional, an installation development system for visual environ¬ 
ments, and DemoShield5, a tool for building software demos and 
product tutorials that promote, show, and sell Windows applications. 

InstallShield Express Professional uses a point-and-click visual 
interface that makes it possible to design and modify installation 
setups for Windows 95, Windows NT, and Windows 3.1 applica¬ 
tions without writing any code. Installation design is streamlined 
with prebuilt InstallShield Objects that automate the installation of 
specific components such as ODBC drivers and the Borland 
Database Engine. 
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Offered in both 16-bit and 16/32-bit (Internet-enabled) configu¬ 
rations, DemoShield5 uses a point-and-click interface familiar to 
Windows users. Demonstrations can be created with the help of 
SmarTemplates that provide every possible element of the demo or 
tutorial, from scene navigation to copyright information. 

InstallShield Express Professional costs $395. Two versions of 
DemoShield5 are available: the 16-bit version, which is $295, and 
the 16/32-bit, which is $495. For more information, contact 
InstallShield Corporation, 1100 Woodfield Road, Suite 108, 
Schaumburg, IL 60173-9946; 800-374-4353 or 847-240-9111; fax 
847-240-9120; CompuServe 76702,1607; info@installshield.com; 
www.installshield.com. 

StratosWare Releases MemCheck 3.5 for 95, NT 

StratosWare has released MemCheck 3.5 for Windows 95 and 
Windows NT. MemCheck detects Windows API parameter errors, 
memory overwrites and leaks, misuse and leakage GDI objects. 
Windows resources, window handles, and other errors that can jeop¬ 
ardize the reliability of a Windows application. 

An assortment of wizards and tools simplifies adding and 
removing MemCheck from projects. MemCheck integrates seam¬ 
lessly with existing C or C++ code and works at runtime to identify 
errors by exact source file and line number in the source code 
(debugging information is not required). Error messages may be 
directed to the screen, written to log files, or sent in network or e- 
mail messages. 

MemCheck 3.5 for Windows 95 and MemCheck 3.5 for 
Windows NT are each $179 (the upgrade from v3.0 for Windows 
is $89) and support the Microsoft C/C++ 7.x 8.x, Visual C++ 2.x- 
4.x, and Borland C++ 4.x-5.x compilers. MemCheck ships with an 
unconditional 60-day, money-back guarantee. Stratosware offers 
free technical support via fax, CompuServe, Internet, and a toll- 
free phone number. For more information, contact StratosWare 
Corporation, 1756 Plymouth Rd., Suite 1500, Ann Arbor, MI 
48105-1890; 313-996-2944; fax 313-996-2955; BBS 313-996- 
2993; CompuServe 70244,1372; info@stratosware.com; 
www.stratosware.comm/swc/. 

Marquis Computing Announces VB/CodeReview 
Professional Edition for Visual Basic 

Marquis Computing, Inc. has announced the release of 
VB/CodeReview Professional Edition for Visual Basic. 
VB/CodeReview automatically reviews Visual Basic code against 
a database of hundreds of bugs and conditions, including 
ActiveX, OCX, VBX, and DLL bugs: Visual Basic 3.0 and 4.0 
bugs; DAO, Jet and ODBC bugs; and Windows API bugs. The 
professional edition includes code formatting and naming sys¬ 
tems, and the tools for developing code metrics like function 
points and complexity. 

As a quality control tool, VB/CodeReview identifies potential 
problems and reports three levels of severity on six categories: 
logic — known bugs and common, but fatal, mistakes; portability 
— conditions that limit project to specific OS/versions; perfor¬ 
mance — conditions that reduce execution speed and bloat exe¬ 
cutable size; Windows API — bugs, side effects, tips and other 
issues; standards — non-compliant object naming and/or coding 


styles; and usability — interface issues such as duplicate or miss¬ 
ing accelerator keys and help. 

VB/CodeReview Pro costs $249.95 plus shipping and handling. 
For more information, contact Marquis Computing, Inc., 5 Youngs 
Rd., Pomfret Center, CT 06259; 800-963-7065 or 860-963-7065; fax 
860-928-7727; info@marquistools.com; www.marquistools.com. 

the doss boss Releases InCOPYnito vl.00 

the doss boss has released version 1.00 of InCOPYnito, an 
application used to prepare reports for claiming copyright. 
InCOPYnito can be used to black out lines of code for the copy¬ 
right application report. While the source code listing prepared 
for the copyright authorities has portions blacked out. the report 
for the user has the same portions visible with a light gray back¬ 
ground. Thus, the programmer knows exactly what parts of the 
code have been released. 

Despite InCOPYnito being a Windows 3.1 program, it can read 
and print large files. The program can output to any printer with bit- 
block transfer capabilities including most laser and dot-matrix 
printers. 

InCOPYnito costs $71.95 plus $2 shipping. For more informa¬ 
tion, contact the doss boss, 905 South Second Ave., #5, P.O. Box 
1626, Sterling, CO 80751; 970-522-0853; jdeutsch@csn.org. 

Blue Sky Announces 32-Bit Help-to-HTML v3.2 
for 95 and NT 

Blue Sky Software has announced a 32-bit version of Help- 
to-HTML v3.2 for Windows 95 and Windows NT. Help-to- 
HTML 3.2 automatically converts the contents tab or contents 
topic of a Windows Help file into an equivalent Web site home 
page, transforms all Help topics into Web pages, and converts 
jumps and popups into HTML hyperlinks. Help-to-HTML con¬ 
verts WinHelp graphics into Web graphic files (GIF) and trans¬ 
forms WinHelp segmented hypergraphics (SHED graphics) into 
Web graphics with corresponding client-side or server-side 
image map files. 

Help-to-HTML version 3.2 is included in the new Moving-to- 
HTML Kit. In addition to Help-to-HTML, the Moving-to-HTML 
Kit also includes the Moving-to-HTML Help tool and the book 
Mastering HTML for Help Authors. 

Help-to-HTML v3.2 is included in the Moving-to-HTML Kit, 
which costs $199. The Moving-to-HTML Kit will be included in 
WinHelp Office 4.0. For more information, contact Blue Sky 
Software Corporation, 7777 Fay Ave., Suite 201, La Jolla, CA 
92037; 800-459-2356 or 619-459-6365; fax 619-459-6366; 
sales@blue-sky.com; www.blue-sky.com. 

Acucobol Releases Acu4GL for ODBC 

Acucobol, Inc. has released Acu4GL for ODBC, a product 
designed to enhance connectivity between COBOL and ODBC- 
compliant data sources. Designed specifically to enhance connec¬ 
tivity to database management systems (DBMS) from Windows 
3.x environments, the interface enables Acucobol COBOL appli¬ 
cations to access a variety of popular databases, such as Oracle, 
Access, and Informix. 
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Applications need be compiled only once to instantly plug into 
any ODBC-compliant data source. Built into Acu4GL's interface is 
an understanding of the language and standards of both COBOL 
and ODBC. Acu4GL works behind the scenes to satisfy each 
request of the executing COBOL application by generating the 
appropriate ODBC calls. 

Pricing starts at $750 for the host interface and one user: each addi¬ 
tional users costs $50. For more information, contact Acucobol, Inc., 
7950 Silverton Ave., Suite 201, San Diego, CA 92126; 800-262-6585 
or 619-689-7220; fax 619-566-3071; info@acucobol.com; 
www.acucobol.com. 

Syndesis Announces Source Code Libraries 
for 3-D File Format Translation 

Syndesis Corporation has announced the availability of the 
source code licenses to Interchange for Windows and SGI IRIX. 
The Interchange system translates between more than 50 3-D fde 
formats, including Autodesk 3D Studio, Microsoft Softimage 
Direct3D. Apple QuickDraw 3-D, VRML, LightWave, trueSpace. 
AutoCAD DXF, Inventor, Wavefront, and Alias. 

The non-exclusive license includes more than 300,000 lines of 
portable ANSI C source code. Under Windows, each file format’s 
converter is a DLL with a simple programming interface. Under 
IRIX, each converter is a similar command line utility as well as an 
X/ Motif application. 

Interchange performs batch conversions, translating sub-objects, 
parent-child hierarchies, rotational centers, and complex surface 
information such as color, specularity and refraction, and even tex¬ 
ture UV coordinates. 

For pricing and additional information, contact Syndesis 
Corporation, 235 South Main St., Jefferson, WI 53549; 
414-674-5200; fax 414-674-6363; www.threedee.com. 

Nombas Unveils ScriptEase-.WebServer Edition 

Nombas Inc. has announced ScriptEase’.WebServer Edition, a 
Web scripting tool with an integrated development environment 
(IDE) and remote debugger. ScriptEase:WebServer Edition is based 
on the company’s ScriptEase language. ScriptEase includes the syn¬ 
tax of C including structures, flow control, arrays, and the tradition¬ 
al C library. 

ScriptEase:WebServer Edition extends the ScriptEase language 
into a CGI. ISAPI, or NSAPI language. ScriptEase:WebServer 
Edition also protects against hard-to-locate stackcrashing and mem¬ 
ory-overwriting bugs. 

ScriptEase:WebServer Edition prices begin at $145 per unit and are 
based on the operating system. To download a trial version of 
ScriptEase:WebServer Edition, visit www.nombas.com and go to the 
Webserver page. For more information, contact Nombas, Inc., 64 
Salem St., Medford, MA 02155; 617-391-6595; fax 617-391-3842; 
nombas@nombas.com; www.nombas.com/. 


eling with requirements analysis and visual development. The 2.0 
release offers major enhancements to each component of the suite, 
including expanded support for defining business models, data 
modeling, and database support. 

KEY:Model. Sterling’s business process modeling component, 
supports organization and process design through the suite’s 
Organization Flow and Work Flow diagrams. The 2.0 release adds 
the ability to further refine business models through individual job 
definition and the definition of goals for organizations, processes, 
and jobs. 

KEY:Workgroup also integrates reverse engineering support for 
existing databases through ODBC, allowing existing databases to 
become the starting point for new modeling efforts. ODBC connec¬ 
tions are also used during DLL generation to automate database cre¬ 
ation and execute the SQL. 

For pricing and additional information, contact Sterling 
Software Inc., 3340 Peachtree Rd. NE, Atlanta, GA 30326; 
404-231-8575; www.key.sterling.com. 

Concentric Data Systems Releases ARPEGGIO 
for the Developer 

Concentric Data Systems, Inc. has announced the availability 
of ARPEGGIO for the Developer, a set of 32-bit development 
tools that enable the professional developer to integrate the data 
access and information publishing capabilities of ARPEGGIO 
software into custom applications. ARPEGGIO for the Developer 
provides three separate APIs that provide a set of tools for build¬ 
ing information publishing applications. Using languages such as 
C, C++. Powerbuilder, and VisualBasic, developers can integrate 
ARPEGGIO’S capabilities into their custom applications. 

The ODBC driver API uses SQL commands to provide the 
components necessary to connect directly to host, client/server, 
and PC databases. The Report Viewer API provides an object 
interface using ActiveX technology, as well as a DLL function 
call interface for traditional development languages. These inter¬ 
faces allow users to publish information from previously defined 
reports. 

ARPEGGIO for the Developer costs $400 per user ($650 per user 
after 31 December 1996). ARPEGGIO for the desktop has a promo¬ 
tional U.S. license fee of $250 per user ($500 per user after 31 
December 1996). ARPEGGIO Viewer costs $99 ($150 after 31 
December 1996). For more information, contact Concentric Data 
Systems, 110 Turnpike Rd., Westborough, MA 01581; 800-325-9035 
or 508-366-1122; fax 508-366-2954; www.walldata.com. 


Sterling Software Announces KEY.Workgroup 2.0 

Sterling Software Inc. has announced the release of 
KEY:Workgroup 2.0, a family of application development products 
for the Windows environment that integrate business process mod- 
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Send letters to wdletter@mfi.com. 


From: “Jason D. Morris” 
<jdmorris@ix.netcom.com> 

Subject: Complex number benchmark 

I have a couple of comments regarding 
your article “Compiler Benchmark: Complex 
Numbers” in the October 1996 issue of WDJ. 
In particular, I’d like to point out some ineffi¬ 
ciencies in the implementation of the com¬ 
plex number class itself. I used Visual C++ 
4.0 to gather all my information. 

1) The inline operator+ and operator* 
functions should take arguments of type 
const Complex &, not just Complex. I placed 
some tracing code inside the ctors for the 
Compl ex class and discovered that both oper¬ 
ators weren’t being inlined and that the copy 
ctor was being called twice as a result. 

2) operator+= and operator*- should 
also be implemented for class Compl ex and 
the third line of the 
ComplexBenchmark::oop_$tyle() func¬ 
tion should be rewritten as follows to take 
advantage of operator+= 

Y[ k ] += factor * X[ k ]; 

This will eliminate the creation of at least 
one temporary. For the purposes of the 
benchmark, the operator*- is really 
unnecessary, but should be included for 
completeness. 

3) It is sometimes more efficient to imple¬ 
ment operator+, operator*, etc. in terms of 
operator*-, operator*-, etc. See p. 107 of 
More Effective C++ by Scott Meyers 
(Addison-Wesley, 1996) for the full explana¬ 
tion. 

I discovered that in this instance, it was 
less efficient to use such an implementa¬ 
tion. However, this may just be a peculiari¬ 
ty of Microsoft’s compiler. 

I’d be interested to see how these 
changes affect the benchmarks. 

That particular benchmark is from Arch 
Robison’s suite, so I don’t want to tinker 
with it. However, I do want to revisit similar 
issues in benchmarks of my own, so your 
feedback is useful. —rib 


From: Tom Brown 
<tbrown @ rocsinc.com> 
Subject: Regmon 


The Regmon utility presented in the 
October 1996 WDJ is a really great idea. 
However, the authors made no mention of 
Win NT 4.0. The registry in NT 4.0 appears 
to fulfill the same role as it it does in Win 
95, and therefore an NT version of this util¬ 
ity would be nice as well. I assume that the 
VxD for Win 95 will not work on NT 4.0. 
Please correct me if I am wrong. If I am 
correct, does an NT version exist? If it 
doesn’t, will it soon? Finally, will it be 
downloadable from the WDJ sites? 

You ’re right that this tool, like anything 
that uses a VxD, is incompatible with NT. 
We usually aren ’t in a position to commis¬ 
sion articles on specific topics, but this time 
we lucked out. Bryce and Mark have 
already made an NT version of Regmon 
and it’s available from their site at 
WWW.ntinternals.com. The utility will 
appear in an upcoming issue of Dr. Dobb’s 
Journal. —rib 


Ron, 

Sorry to bother you with this, but I sent 
a subscription renewal to wdsub@mfi .com 
(the email address under Customer Service) 
on September 23rd, and then a followup 
message on September 28th. Neither mes¬ 
sage was answered (and neither bounced). 
Is this address correct? 

Thank you 

Tony Cook 
Sydney, Australia 

That is the right address but email is not 
100 percent reliable, and my experience is 
that the Miller Freeman email system has 
been having significantly more problems 
than our old R&D Publications system did. 
Of course, the R&D email had its own 
problems in its youth, so maybe there’s a 
law of nature at work here. In any case, if 
all else fails, try sending me email at 
70302.2566@compuserve.com — we want 
every reader to get every issue! —rib 


Subject: Miller Freeman 
Dear Ron, 

I’m convinced now that the Miller 
Freeman buy was good for WDJ. I'm liv¬ 
ing in a medium-sized Italian town, and 
now WDJ is for sale in the newsstands, 
together with the other MF magazines. I 


hope that now WDJ can be better known 
in Italy. Regards (and excuse me for my 
poor English). 

Massimo Poletti 
Ferrara, Italy 
100304.2475 @ compuserve.com 

Better newsstand visibility overseas has 
definitely been one of our goals, so it's 
good to hear that’s really happening. We’ll 
probably never have the newsstand pres¬ 
ence of some of the big magazines, but we 
do keep gaining ground, a little here, a little 
there. Thanks for letting us know the maga¬ 
zine is making it out there! —rib 


Sb: #C++ Magazines 

Fm: Steven Carr [100251,1571] 

Ron, 

I have been getting Windows Developer’s 
Journal from the local newsagent (in 
Australia). The problem for the past number 
of months is that they are no longer able to 
track it down in their lists of magazines. Can 
you give me some details of the publisher, 
etc., so as I can track down the magazine. 
Suffering massive withdrawal symptoms... 

Our web site at WWW . wd j . com has a page 
devoted to our newsstand sales. You can 
either call the number listed there to track 
us down in a given country, or send email 
to wdsub@mfi .com and we’ll try to locate 
the newsstand closest to you. —rib 


From: “Caixa Galicia” 

<caixagal03 @redestb.es> 

Subject: Bypass print device 

We need to bypass the printer device 
driver in order to send PCL codes to the 
printer. The February 1996 and August 
1995 issues of WDJ contained this topic. 
How can I get this quickly? We need this 
information yesterday!!! 

Our Web site at www.wdj.com is the 
source of all knowledge. Well, maybe not, but 
if it doesn’t answer the most common ques¬ 
tions like this, please let us know and we 'll fix 
it. The Web site lets you download the code 
for the articles you ’re looking for. If you need 
the article in addition to the code, the Web 
site can help you order them via fax, phone, 
or directly (assuming your browser supports 
Secure Sockets Layer). Back issues are $9 
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each (plus S&H), so if you’re going to 
order several, you might elect to splurge 
and get the $49.95 CD-ROM that contains 
four years of back issues along with a full- 
text search engine. —rib 


Subject: Borland DLLs and non-Borland 
EXEs (win 16) 

From: markajones@juno.com 
(Mark A. Jones) 

I appreciated your article about writing 
Win32 DLLs that are accessible from 
diverse environments. Have you run across 
the following problem? 

It seems that 16-bit Borland DLLs that 
use exception handling assume the stack seg¬ 
ment will have a 10-byte area starting at off¬ 
set 0x10 for managing exceptions. Borland 


EXEs conform to this assumption, but at 
least one (apparently) non-Borland EXE I’ve 
run across does not. It stores its own precious 
data there, which the Borland DLL happily 
overwrites, causing the app to crash. 

Am I missing something, or can 16-bit 
Borland DLLs only be linked with 16-bit 
Borland EXEs? 

This was a big mess when Borland first 
implemented this scheme and neglected to 
tell developers that their 16-bit DLLs 
would not work with non-Borland apps. 
Fortunately, since then they have remedied 
the situation, at least for those of us who 
aren’t using exception handling anyway. 
First, make sure you compile your DLL 
source files with the “-X-” option so the 
compiler knows you aren't using exception 


handling. Second, link your DLL with 
NOEHxx.LIB, where the “xx” depends on 
your memory model and environment. For 
example, to link a Windows large-model 
DLL, use noehwl . 1 i b as the first library in 
your link command. I believe 32-bit 
Borland DLLs have another set of prob¬ 
lems related to exception handling, but I 
haven't researched it enough to really 
understand it — too much time with DLLs 
can make my head hurt. —rib 


From: “Teska, Lynn C.” 

<lteska@mayo.edu> 

Subject: mstater 

I’ve tried to apply all the WDJ annota¬ 
tions to VC 4.2. This fails because many 
topics are not found. The quickinfo portion 



Developer's 

Marketplace 


™ STARMAKER SYSTEMS INC. 
- 173 Thomson Ave., Regina, SK 

Tel: (306) 596-2575 
www.starmaker-systems.com 

StarTools™ are quality utilities for 
Windows and Paradox developers. 

Available NOW - get your copies today! 

StarTime - FREE ! network PC time synchronizer. 
StarCLID - PC Interface for TelCo Caller ID data. 
LoadStar - checks PC configuration & pre-installed 
programs before allowing new program to install. 

Available 4Q’96- reserve your copy now! 

StarDate - perpetual calendar with library connection to 
Paradox application forms. 

Captains Log - journal logging of application table 
changes. Full audit trails. Perfect for disaster recovery. 
StarLicence - counts & controls number of licensed 
users on networked PCs. 

StarLock - provides a lock for one or more Windows 
program groups for unattended PCs. Great for shows. 
StarSecure - provides excellent security & multi-layer 
user access for Paradox application forms & tables. 

□ Request Reader Service #168 


CDROMs! 


Linux Slackware* 96-4 disc set. Slackware 96 ‘OFFICIAL* 
release by Patrick Volkerding. Internet's favorite! You get 
complete source code and compilers. Free 36 page 
installation booklet. No floppy disc install! $39.95 

Slackware subscription - convenient 3 month updates. $24.95 
FreeBSD® 2.1.5 - Berkeley BSD for PC. Solid Unix®-like, src, 

XFree86 3.1.2, dev. tools. 2 CDs. (Subscr. every 6 mo. $24.95) $39.95 
CUG Library - 10 years C/C++ Users' Journal src, listings. $49.95 
CICA® MS Windows - 1,916 up-to-date shareware. 2 CDs. 529.95’ 
Hobbes® OS/2 Archived - 950 MB OS/2 apps, drivers. $29.95' 

Blackhawk 95 - 520 MB great Windows 95 applications. $29.95' 
Toolkit for Quake - addons for the hottest selling game. $19.95' 
Simtel® MSD0S - 2 disc set, classic MSDOS shareware. $29.95' 
Science Library - Technical, engineering shareware + book. $39.95' 
Perl - Source, binaries for many systems, documents. $39.95 
Math Solutions - Math programs, source code, docs. $39.95' 
POV-Ray - 3-D Raytracing: 1000 wow! images, src/binaries. $39.95 

•Shareware programs require separate payment to authors if found useful. 


ORDER NOW! 1-800-786-9907 


Shipping is $5 in USA/Canada/Mexico, $9 Overseas per order. 



Walnut Creek CDROM 

Suite D-694, 4041 Pike Lane, Concord CA 94520 
Phone: +1-5106740783 • FAX: +1-5106740821 • email:orders@cdrom.com 
All of our CDROMs have a one year unconditional guarantee! 

Call today for your free catalog of all our CDROM titles! r—-—-- 1 

See these products free at http://www.cdrom.com/ Adcode: 694 
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Looking For Something? 


WinGREP can find it 

WinGREP is a multi-file search 
utility that can quickly locate text 
strings in source code files. 
Tight integration into over a 
dozen editors and integrated 
development environments 
(IDE’s) sets WinGREP apart 
from other search utilities. 
WinGREP can be customized to 
automatically synchronize an 
editor or IDE with the results of a 
search. Not only does it open 
the file, but it will also position to 
the line of the match. The ability 
to display the results of a search 
in a programmer’s native work¬ 
ing environment makes main¬ 
taining volumes of source code 
a manageable task. 


c Optimized for programmers 
<7 Very fast search performance 
•f Save, load, and print results 
•7 Easy regular expressions 
■7 Long file names 
>7 UNIX text file support 
7 Quantity pricing available 



Trial Version Available 

$39 + 4SH(US) 
Toll Free 24hrs (US) 

( 888 ) 946-4737 


Hurricane Software, Inc. 

www.hurricanesoft.com • CompuServe go WINUTIL 
e-mail mail@hurricanesoft.com • CompuServe 102470,2564 
2401 SE 7th • Blue Springs • MO 64014 • (816) 373-9252 


DISKETTE & 
CD DUPLICATION 


Let us send out your Demo Disks 

• DISK DUPLICATION 

• LABELS/DISK & CD 

• CD DUPLICATION 

• FULFILLMENT 

• BLANK MEDIA 
• LOW PRICES 

• FAST TURNAROUND 

DUPLICATION TECHNOLOGIES, LTD. 
P.O. BOX O, WELLINGTON, MO 64097 
TOLL FREE (888)899-3475 
PHONE (816) 934-8518 FAX (816) 934-2590 


g Lexicus Longhand 

Handwriting Recognition Software 


Software Development Toolkit 

Use our new SDK for high user acceptance 
of your pen applications. Lexicus Longhand 
provides a fast and natural method of data 
input. With our SDK, the creation and 
prototyping of your pen-based applications 
has never been easier. The SDK includes: 

- Dictionary Building Tools 

- Custom VBX Controls 

- Documentation 

- Code Samples 

1-800-LEXICUS 

415-462-6800 

http://www.lexicus.mot.com 


MOTOROLA 

Lexicus Division 
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Software Developers! 


PROTECT YOUr 
Software. 
INCREASE Your 
Revenues. 

With software piracy costing you 
50% of your revenues, you can't 
afford not to protect! HASP® is 
the industry's most secure, flexible 
and easy-to-use software protection 
solution - rated #1 by the NSTL! 

HASP will help you increase sales, control 
distribution, prevent piracy, monitor network 
licensing, and much more! 

To learn how you can easily sell more software - call 
now to order your low-cost HASP Developer’s Kit! 

www.aks.com 



Norh America 800-223-4277 
212-564-5678, Fax: 212-564-3377 
E-mail: hasp.sales@us.aks.com 
International -972-3-636 2222 
Fax: 972-3-537 5796 
E-mail: hasp.sales@aks.com 


ALADDIN 


The Professional's Choice 
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CAREER OPPORTUNITIES 
NATIONWIDE 
$40,000 - $120,000 


. Windows' 3.X, NT, Win 95 
. Network Programming Tools 
. C, C++ 

. Visual Basic Tools 
. PowerBuilder 
.Delphi /ORACLE /GUI 
. Many other computer 
disciplines served 



Ansara, Bickford & Fiske 

The Computer Specialists 


Contact Mr. Peter Kratimenos 
P.O. Box 239, W. Spfld., MA 01090 
Tel (413) 733-0791 Fax (413) 731-1208 
See Our Web Site at: 
http://www.ansara.com 
e-mail: pk@ansara.com 
2,000 Affiliates Worldwide 

3 Request Reader Service #146 3 


Developer Jobs! 

Internet: ngi@scientific.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NTi Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
and real-time, compilers, etc. Managed by 
graduate engineers. Send resumd or call fora 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.scientific.com 

Compuserve:71250,3001 AOLrdavesmall 
SPI8, Box 19949, Houston, TX 77224 
713-496-6100 Fax:713-496-0373 
SPI8. Box 71. San Ramon, CA 94583 
510-733-6168 Bcth@sptca.bdt.com 
SPI8, P. O. Box 202676, Austin, TX 78720-2676 
512-331-0302 lej@zilker.net 
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VICTOR 

Image Processing Library 

Fast BMP/TIFF/PCX/GIF/TGA/JPEG 
Powerful image processing: brightness, 
contrast, sharpen, smooth, equalize, 
create filters, resize, rotate, +++ 
Accurate color reduction to optimum, 
specific, or standard palette 
Print halftone, diffusion scatter, or color 
Scan with all HP scanners 
Operate on single image, multiple 
images, or any image area 
Crop, combine, and compare images 

Victor Image Processing Library 
Dos lib $199,16-bit DLL $299, 32-bit DLL $499 

Catenary Systems 
314-962-7833/fax: 314-962-8037 
email: victor@catenary.com 

askforfreedemo srcavail noroyalties 
Visit our website for demos, app notes, and sample code 

http://www.catenary.com/victor 
o Request Reader Service #153 □ 


DKYKT. DRIYF.lt DEVELOPMENT 


NDIS • VxD • VDD 


Port your Windows 3.x drivers to 
Windows 95 and NT. 

We have over 4 yrs experience in 
developing Device drivers for 

• Barcode Scanners 

• Network Cards 

• IRDA Devices 

• Serial Communications 

Infosolv Inc. 

(800) 775-7658 
info@infosolv.com 


Yisit us af htt|>://\v\v\v.infosolv.com 


I.... I 
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C++ te HTML (kind 

j RTF Occbimemtatien 

• Object Outline extracts comments directly from source 

• code. Requires no source changes or ugly comment tags. 

! Combine external design documents, source code, and 

• comments into a single, coherent, up-to-date document. 

• Automatic hyper-linking. Integrate into an internal WWW 

• project page. Works with all the major 32-bit Window compilers. 

• Visit us on the web for a working demo and 

• samples. Windows 95 and NT 3.51—$297. 

I Order by calling 1 -800-214-4746, 

• fax an order to 1 -800-657-8141 



More info: Web site www.bbeesoft.com, 
email info@bbeesoft.com, PO Box 541, Hudson, MA 01749 
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Market and 
Publish Software! 


Astron Publishing, Inc. seeks software 
products to publish in the marketplace. 

If you have developed an innovative and 
creative game, program or utility, Astor 
will review your program, determine its 
market potential, and publish the 
finished product, 

As tron 

PUBLISHING, INC. 

110117th Street, N.W., Suite 408 
Washington, D.C. 20036 

Tel 202-331-9789 Fax:202-872-0286 
Toll Free: 800-982-2578 
http://www.wbonepub.com 


GAMES WANTED! 


Windows NT Drivers 


Development 

Consulting 

Training 

by the best in the industry 

• File Systems • Kernel Mode Drivers 

• NDIS Drivers • Systems Internals 



105 Route 101A, Suite 19 

Amherst, NH 03031 

(603) 595-6500 — info@osr.com 


Call or email for a free no obligation quarterly subscription to 
The NT Insider , the world’s only newsletter dedicated entirely 
to Windows NT systems software development! 



Explained and Illustrated in Graphs 
Specifically for Different Positions & Skills 

• Programmer • Programml\g 

• Quality Assurance Language 

• Administrator • Software 

• Support • Network 

Including: 

C/C++ Programmer 

Visual Basic/Powerbublder 
Programmer 

Instant Online Download 

http://www.whoIeroot.com 

Whole Root™ Economic Research. Inc. 
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of the search seems to be the problem. Is 
there a fix? 

Unlike other compiler vendors , Microsoft 
typically doesn 't send us copies of their prod¬ 
uct, so I generally have to buy them myself. 
Unfortunately, I’m too cheap to pay the real¬ 
ly big bucks for their "subscription,” so I 
simply don’t have a copy of subscription 
updates like Visual C++ v4.2. When VC++ 
v5.0 comes out, I’ll buy a copy and I should 
be able to fix the problem then. —rib 


From: “Ross A. Virostko”<ross@bellhow.com> 
Subject: mstater 

Exactly how/where do you execute 
mstater? What exactly do you mean by 
open the Info Viewer window? 


MsTater is an ugly little spud that 
attempts to cram our SDK annotations into 
the proprietary Microsoft Developer Studio 
online help system. There’s no documented 
API or hooks for doing this, so MsTater has 
to resort to looking for windows, simulating 
button presses, sending cross-application 
text, and the like. It’s pretty fragile, and I did¬ 
n’t have a lot of time to spend on it (but it’s 
free!). To work, MsTater wants you to have 
already started up Developer Studio, and it 
further wants you to have opened the 
InfoViewer window inside Developer Studio 
(that’s the online documentation system). 

There’s also a bug in MsTater that a read¬ 
er recently pointed out. The InfoViewer win¬ 
dow must be maximized, otherwise MsTater 
will not correctly detect its existence. I may 


be able to fix that one. Also, note the previous 
letter — MsTater doesn’t work with Visual 
C++ v4.2, since Microsoft apparently 
changed how the topics are indexed. 

Because the Tater family is an unfunded 
skunkworks project, I coded it at a dead 
run, and it’s made up of lots of very poor 
code. For that reason, I’ve avoided includ¬ 
ing the source code with the utility. 
However, more than one reader has asked if 
they could get a copy so they could just fix 
the darn thing. Therefore, I'm going to start 
including the source code in our standard 
sdkann.zip^zfe. I’ll probably put a note at 
the top that says “Please don’t send me 
email to tell me how bad the code is — I 
already know.” You can get sdkann.zip 
from our Web site at WWW.wdj . com. Newer 



Need Printing & Previewing 
For Your Window^Apps? 

Download a fully-functioning trial of Virtual Print Engine * 
right now at www.aridsoftware.com/200.htm 


• Well-documented Dll 
•1/1 Omm control 



> Handles text one/graphics 
»to routines! 


16-bit or 32-bit: $398 Both: $598 

For more info or free demo: 

E-Mail: sales@arialsoftware.com 
Phone: (503) 6464515 
Fax: (503) 646-6717 

"Your VPE DLL is great!! Thanks again! 

It is just what the doctor ordered, and will 
save me many hours of work." 

-U ■ ' 
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C and C++ DOCUMENTATION 


!! VERSION 6.2!! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C 1 * statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers, 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BR0WSE Windows graphic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
0NT Canada L5N-4M1 http://www.swbs.com 


Please see Ad Index for our larger ad. 
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Add ZIP (and UNZIP too!) to 
your Windows applications! 


fDynaZIP 30 

I Data Compression Toolkits 


The new ROYALTY-FREE DynaZIP family of 
developer's tools let you add ZIP and 
UNZIP capabilities to your Windows 
applications. No more "shelling" to 
DOS, no more fussing with proprietary 
compression formats. DLLs, VBXs, OCXs 
and a new databdse interfdee provide 
full access from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: [800] 962-2949 


Inner Media. Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
http://www.innermedia.com 
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IW3 WWW Connectivity * * * UNIQUE * * * 

• Connect applications with the World Wide Web • Make 
host application useable through web browsers • 3270. 
5250 and 9750 available via HLLAPI • HTML generator 

• VisualBasic support - Write a web server with VB - 

PicaSSO Interface Generator 

• Creates new interfaces for existing host and DOS apps. 

• Supports 9750, 3270 and 5250. • HLLAPI interface • 
Built-in form editor • Transformation tools • Codegenerator 
produces complete program source • Host screen capture. 
WWW option available. 

PrimaVista Interactive Presentation 

• Annotations with mouse, keyboard and pen. • Screen 
camera, graphics import, Photo CD. • Arrange, scale, crop, 
undo and redo. • RTF editor and thumbnail images. 

T OOls PrimaCamera and WinGate Products 

• Camera captures popup menus • WinGate: DOS pipes • 
RobinHood: DOS box control • WinTunnel: data exchange 

PrintForm Formatting Tool 

• Makes impossible reports possible. • Lean, mean and 
fast, supports MFC • Suited for object oriented data bases. 

0)+49.89.78581204 ESC 
1 +49.89 78581205 0) +1.913.832.2070 
info@cobasoft.com ®+1.913.832.8787 
Cobasoft www cobasoft com www esconnect.com 
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S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer's 
Mind. 3 * 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it’s time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace forthem... 
we understand you. 


8 Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 
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Free demo 




* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* SpellCheck/VB - spelling & lookup. $49 

* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree index..$f 49 

* VoxLib/Pro - telephony (multi-line) ...$799 

* CodeClipper - code bank & cut/paste ....$99 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming „..$80/h 
Develop your VBapp faster: Get TeraTech tools! Call, E-mail 
or fax us and well mail you a free demo disk ASAP. Or for 
faster service download by FTP or from our BBS. Gall now! 


800-447-9120 ext. 1260 

Dept 1260, 100 Park Avenue, Suite 360j Rockville MD 20850 USA 
Int’l:+1-301-424-3903 Fax:(301)762-8185 BBS: (301)762-8184 
info@teratech.com http://www.teratech.com/teratech/ 
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Demo / Tutorial / CBT / Presentation 


Visual Windows Automation 
Multimedia Authoring Development Kit 

U Use ShowBasic Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

Q Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

LI Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP, WMF, WAV, MIDI, AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

LI Deliver your titles transparently via WWW - 
ShowBasic can be integrated with any WEB browser. 

Development license $299 with AO day money back guarantee. Royalty free license SH95. 

If you don't need all the power of ShowBasic - use our simple, 

yet flexible scripting language for live demos and automation: 

srinn>iEiis!io -itp it - 

Single-user license $30 ($60 Pro), Royally free license $300 ($500 Pro). Visu/MCaccepted. 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 

■ MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ. 08816 
Internet: mik@cnj.digex.net CompuServe: 74127.3671 
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ZIP 


XCEED ZIP 

COMPRESSION LIBRARY 


16 and 32-bit Delphi VCLs, VBX, OCX 


Finally, a compression component that 
gives you your money's worth! Add 
Xceed Zip to your project, set a few 
properties, and your apps will be ziping 
and unziping in minutes. Great for 
automating backups, preparing files 
for transmission, or developing your 
own custom installer. 



( 800 ) 865-2626 
( 5 - 14 ) 442-2626 


Visit www.xceedsoft.com dev for a 
free trial version and find out 
why Xceed Zip is rapidly becoming 
the most popular VB and Delphi 
compression library! 
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Cash in on 
the Voice 
Bonanza! 


Get your piece of the $3 billion Voice Industry - 
develop your own Computer Telephony Apps! 


Add voice power 
to your Windows 
apps with TI/F 
DLL '" (CT Mag's 
Product of the 
Year), our popular 
interface to 
Dialogic™ multi- 
line telephony 
hardware. 


Audio ToolBox ™ 
lets you batch 
process and 
convert audio files 
to & from standard 
formats. Adjust 
volume, filter, trim 
silence, more! Add 
to your apps with 
ToolBox SDK. 


Call and ask about 
our VFEdif 
professional voice 
prompt editor, 
Scribe " trans¬ 
cription utility, 
VoxFonts* text- 
to-speech library, 
plus more great 
products! 


f/S7 800-469-4874 


VISI, 2118 Wilshire Blvd, #973, Santa Monica, CA 90403 
310-392-8780 Fax: 800-234-FXIT / 310-392-5511 • sales@vinfb.com 
BBS: 310-392-6610 www.vinfo.com (Download Working Demos) 


MAKE $500,000 
PER YEAR! 


-as a recruiter in the computer industry. 

Did you know that... 

• The average company paid fee is 
$12,500! 

• The average recruiter earns $200,000 
per year! 

• Placing just 4 people a year will make 
you more money than 98% of the 
population currently earns! 

You have the knowledge, you just don’t know 
the rules. For $19.95 plus $3 S&H I’ll show 
you how! Call the recording below for a full, 
detailed explanation of how you can finally... 

earn what you are worth! 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


Data processing 

I NDEPENDENT 

Consultant's! 

E xchange , 

A Service of D&L Online, Inc:. (515) 280-1144 
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MFC 3D Modeling Extensions 

Need to add 3D modeling capabilities to your 
new or existing MFC based products? MEX 
is a full featured, robust, no compromise 3D 
modeling application framework featuring: 
Object/Tool/Editor architecture 
Extensive math library 
Orthographic and Perspective views 
Import/Export facilities 
Unlimited Undo/Redo 
2D/3D Bezier Spline editor 
Mesh/Light/Camera editor 
Generalized Cylinder editor 
And much, much more. Windows 95/NT 
All four modules OV\y.$\W (Personal) 
Call today: 914-267-2059 
Source Available Visa/MC/COD 

B&F Software Solutions Inc. 

44 Follim Way Congers, NY 10920 
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■Business Applications 



Create mission-critical, multi-user 
business applications NOW with PRO/5™! 


• Easy to learn and use 

• Scaleable from 
1 to 1,000+ users 

• Windows 3.x/95/NT, 
DOS, Novell, and UNIX 

• Affordable 

• World Wide Support 

Call 1.800.423.1394 
info@basis.com 
http://www.basis.com/ 
BASIS International Ltd. 
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Dr. DeeBee" 
ODBC Tools 


Tools for ODBC development 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 



Dr. DeeBee ODBC Driver Kit 



Conned proprietary databases to 
Access, Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 


snm^E.: - 

RO. Box 91 Kendall, Cambridge, MA 02142 
G17-497-1376 Fax 617^97-8729 
http://wvwv.syware.com 


□ Request Reader Service #169 □ 


January 1997 


• windows developer’s journal • www.wdj.com • 


79 











































































(i.e., untested) versions sometimes appear 
on my home page at 
http:://ourworld.CompuServe.com/ 
homepages/RonBurk. — rib 


From: Ron Lauzon 

clauzon @ fle. gmpt.gmeds .com> 
Subject: ISDN books 

I just read your “From the Editor” col¬ 
umn in the November 1996 issue of 
Windows Developer's Journal. I hope that 
you can return that $200 worth of ISDN 
books you purchased. U.S. Robotics has 
just announced a “breakthrough” in modem 
technology that will let you have a 28.8 
KBPS send channel and a 56 KBPS receive 
channel over normal phone lines. They will 


have an upgrade plan for those people who 
currently have 28.8 or 33.6 KBPS modems 
to get these new features. 

Many online services have already com¬ 
mitted to upgrading their dial-up ports 
when the new modems come out. Between 
this new modem technology and the seem¬ 
ing desire of the phone companies to kill 
ISDN in favor of ATM, it would seem that 
ISDN is soon to be only a part of a chapter 
in the history books. 

Somehow I doubt that Barnes & Noble 
will accept “rendered useless by evolving 
technology” as a valid reason for issuing a 
refund on books! Of course, ISDN offers 
more than just speed — you get much 
faster connect times, the ability to put your 



Developer's 

Marketplace 


ActiveX Charge 

Add Credit Card Processing to Your Applications. 


PC-Charge makes it easy to process Credit Cards, Debit Cards 
and Check services in your Windows Applications. Sales, 
Credits, Voids-everything you need to replace that bank card 
terminal (little black box). 

• ActiveX and VBX Controls make it easy to integrate. 

• Pre-Certified with all major credit card processing 
companies. 

• Single and Multi-User Versions. 

• Works with Visual Basic, Visual C++, PowerBuilder, 
Access, Delphi and many more languages. 

• 30 day money back guarantee. 

• Starts at $295. 



The Leaders in Innovative Transaction Processing Solutions 

31 Sherborne Road • Savannah, GA 31419 
Tele: (912) 925-4048 Fax: (912) 927-0214 
http://www.gosoftinc.com 
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The best high 
performance, 
portable 
compression 
libraries for 
DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 


FREE DEMO 


DOS 
Win 16 
Win32 
OS/2 
Unix 


$249 

$299 

$299 

$349 

$349 


Macintosh $349 


45-function API 
Buffer compression 
File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 
Tel 606-245-4175 
Fax 606-245-9305 


DC Micro 
Development 

Call 1-800-775-1073 

info@dcmicro.com http://www.dcmicro.com 


COPY PROTECTION 

INTERNET ACTIVATION 

Az-Tech Software, Inc. 

Leaders in Software Security 





INTERNET 
CPU-LOCK 
HDD-LOCK 

CD-ROM LOCK (Software Based) 
REMOTE ACTIVATION 
EXECUTION LIMITS 
LIMITED INSTALLS 
REMOTE RESETS 
SERIALIZATION 
REGISTRATION < Securc Distribution) 
ACCESS FLAGS 
DATE LIMITS 
NET LIMITS 
"POINT & SHOOT” 

WIN95*3.11*DOS (Hardware Based) 
Phone: (8X6) 776-2700 x320 
Fax: (816) 776-8398 * Dept: SMG-320 
Internet: www.az-tech.com — 
E-Mail: sales@az-tech.com [20 
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bandwidth to different tasks (phone and fax 
at the same time!), and more. You may be 
right that ISDN is dead, but there definitely 
seem to be people who haven't noticed. My 
local phone company claims to have sever¬ 
al people devoted full-time to doing resi¬ 
dential ISDN hook ups. Certainly the con¬ 
cept of being connected digitally rather 
than hisses and shrieks is appealing. It 
may all be too little, too late on the part of 
the phone companies, but I don’t think the 
game is over quite yet. —rib 



Visual C++ & Delphi Support! 

ER modelling tool with Form Generator, Logical & Physical 
Database Design, Reverse Engineering, Triggers & Stored 
Procedures, Scripting Language, Programmable Database 
support and hundreds of other features. 

Pro Edition Only $485 
Case Laboratories, PB 58,4033 Forus, Norway 
Fax (47) 51 57 01 17 email: JANVB@CASELABS.COM 


Download a I RV.l. Demo from 
www.caselahs.com 
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Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 


Reach the core of the 
Windows programming market: 

Windows 

□ DEVELOPER S JOURNAL 

The Magazine for Windows Programmers 

Call 91 3-841 -1 631 today 

for information about 
advertising opportunities in 
Windows Developer's Journal. 


I Ed MacMillan - East I Daniel Lassley - West 
913-838-7513 I 913-838-7541 

I breakout! marketing - Continental Europe 
+49 431-801740 
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Scan, Display 
Document Imaging 

Sts* 

Scale-to-Gray 




• - 


Kroeessmg 


Special Effects 


- and Much MoreJ v 


The Next Generation of Imaging Technology for Developers™ 


ImageGear™ 6.0 shifts your development schedule into 
warp drive by providing you with the most 
comprehensive, easiest to use image processing solution 
available. With support for over 45 file formats and an 
API featuring 200 plus functions, ImageGear is the 
toolkit that no developer should be without. 

Standard and Pro Gold™ versions allow you to purchase 
the level of performance and functionality you need. 
ImageGear offers the high speed display of both bitonal 
and full color images with functions like scale-to-gray, 
automatic aspect-ratio correction, panning window, 
magnify window, and much more. Advanced features 
like auto-deskew, sub-pixel display accuracy, rotate to 
any angle, and special effects add robust image 


processing to any application. ImageGear’s new display 
technology is fast and easy to use and printing is more 
accurate than ever with new high-level functions. The 
TWAIN scanning interface with support for 32-bit 
drivers gives you complete control. GUI functions 
make integration quick and seamless, and multi¬ 
platform support provides a complete solution to 
portability issues. 

The AccuSoft Image Guarantee™ assures that your 
application will read every valid image. You can turn to 
us with confidence because we have over ten years of 
experience as the leader in quality image processing. 

So call the experts at AccuSoft, and step up to the next 
level in quality and performance with ImageGear. 


Visit our Website @ www.accusoft.com 

0k FREE ImageGear 6.0 Demo 0k Comprehensive Product Info 
0k ImageGear Special FX in Action Imaging Toolkit Glossary and Much More! 


AccuSoft Corporation 

Two Westborough Business Park 
Westborough, MA 01581 
Tel (508) 898-2770 
FAX (508) 898-9662 


AccuSoft 

High Performance Imaging 

Call for FREE Demo! Toll Free: (800)741-7720 


MINUTE 

Delivery 
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Windows 
Win95/NT 
MIPS NT 
Alpha NT 
VBX 

ActiveX(OCX) 

OS/2 

SUNOS 

Solaris 

HP-UX 

AIX 

SGI 

SCO 

MAC 

PowerMac 


TIFF 
JPEG 
PCX 
JFIF 
TGA 
Group 3 
Group 4 
PGM 
DIB 
IMT 
DCX 
BMP 
KFX 
RLE 
LV 

CALS 
ATT 
CLP 
XWD 
XBM 
IFF 
SUN 
PNM 
IOCA 
GX2 
XPM 
ASCII 
CUT 
GEM 
BRK 
MAC 
PSD 
MSP 
PNG 
PCD 
IMG 
IGF 
SGI 
ICO 
PBM 
PPM 
MO:DCA 
WMF 
WPG 1 
PICT 1 
EPS 1 
GIF 2 
ABIC 3 
CIF 3 
JBIG 3 
DICOM 3 
and others 







The comprehensive imaging toolkit 


Import/export and display 
40+ image file formats 


z 



LEADTOOLS PROFESSIONAL EXPRESS 


NEW LEADTOOLS 6 km lad* rrnythm* you need to rupport rUn ®i?fi in you t «ppl>r*Uofi 
i WeW docuiwri BMging. to imipnt to 16 through 16 ooDtor. color d«ktop «n«gjng 


C*lgr CmmhIm Expavt or reduce nr. «.»$*'» color depth with i 
euetonSMdor optuuiedpelettee Sepueterieccnetruet tnnntge toll 
CM Y. HSVN^HoL colorpl*n« LEADTOOLS elro suppor^fc 
routedseteenc 


Amiotatini 


amtgee Include* tea, highlight«, sticky «rter, 
ifblectouf), button*, hotopoo, pointers, eudio. 


|fii]gg|v-' 


40+ processing 
features 
including: 
rotate, resize, 
crop, transpose, 
reverse, sharpen, 
blur, brighten, 
darken, hue, 
saturation, 
intensity, emboss, 
contrast, mosaic, 
posterize, line 
detect, edge 
detect, histogram 
equalize, median 
& noise filter, 
spatial filter 
(gradient, 
laplacian, sobel, 
prewitt, shift and 
difference, line 
segment), 
underlay, 
autodeskew, 
despeckle, and 


NEW! 


Annotation 


features include: 


add text, 
highlighter, 
sticky notes, 
ellipses, 

rectangles, lines, 
free hand 


scribbling, 
redaction, 
buttons, hot 


spots, pointers, 
audio, bitmap 
stamps, polylines, 
polygons, and 


more. 


ri!e IV .... ........... 


1» (Mhciing method* ucing 
ukvidud ROB. CMYK. 
Send halftoning with 


Display Optimized tendering of my image to til 
fixed peletU OfUoo will elutoruto ihe pile lie shift 
i»«ntun the hut mugs quality Easy to uee ■ 
appkciUon fly The 2J4 »h*de 3ealeToOray 
enhance fee quality and readability of the i* ‘ 


•drthenng md scaling The I 
kit device, y*t will 

foil crop, and par. will make your ; 
:k viewing options wUl 


Processing Get 
rotate (01*), dip. or 
intensity detect, stretch 
mosaic, shear, poetenze. 
difference, hne segment), 
functions to draw - (bract! 

Region of Interest 

You can speedy regions 
can be composed of any 
Polygons. 6: more 


practically all Known 'flavors'; at different pixel depths 
http /Anew leedtook com/formaU tin 4 .. 


presen g funcuons metudoig resize, interpolated resize, 

'a. sharpen, blur, bright(taken. hue ic i duration. 

S. gamma coned, htstogram equalize, edge dated, kna detect, 

se filter, spdtal filter (gradunt, laplactaa rebel prewitt, shift U 
io deskew. despeckle. & more. You can even use Windows GDI 


i proctssxigwtegicn* 
is. Free-hand shapes, 


Compression No other toolkit offers as many compression options irehidmgCCITT 03 & 04, 
CompuServe's new lossless PNO, JPEG and LEAD'S own prepnstary CMP LEADTOOLS delivers 
fastest software only JPEG algorithms The CMP format results m smaller file sues and maintains ’ 
image quality than industry standard corapiessir.fi formats 

Pr i tiling LEADT0013 6 performs all the image processing necessary to pnnt to any printer with i 
highest quality and has the capitoikty to pnnt text and multiple images on the same page 


□jllooflal debveri over 200 ftmetions to read, write, compress, image process, tisplay (scroO, zoom. & 

1 si), pnnt, sen, & more New features include armor aticr.. region processing and support for severd 

_file formats With the new internal modular desiyi you can reled the eomponesitojrcdj need for you | 

specific devatopmert scecano and keep the size of your application to a minimum cl>j 

Scantling Support* 14* 32 bit TWAIN interface* for dnvmgthe most popular seaming devices 


/ Formats 


BMP 

IMG 

MSP 

TGA 

CAL 

I0CA 

PCD 

TIFF 

DIB 

JPEG 

PCT 

VDA 

EPS 

JFIF 

PCX 

VST 

FAX (raw) JTIF 

PNG 

WINFAX 

DCX 

LEAD CMP 

PSD 

WMF 

GIF* 

MAC 

RAS 

WPG 


NEW! Progressive JPEG 


Get to LEAD'S FTP Site 
and check the list out 


NEW! Use region processing 
on a specific area in an image 


Image is everything! Take advantage of the same imaging technology 
that is utilized by Corel, AT&T, McDonnell Douglas, Xerox, Sharp, 
Delrina, Microsoft, and others! The combination of LEADTOOLS 
mature and stable code, together with the rich image processing 
features, our extensive file format support and industry leading 
compression options, makes this toolkit the only choice to integrate 
imaging into your application. Whether you choose one of the 
LEADTOOLS Pros or LEADTOOLS Pro Express, you are guaranteed 
the most comprehensive imaging solution available! 

The award-winning LEADTOOLS 6 is everything developers need to 
integrate black & white, grayscale, and color images into any 
WIN 16/32 or OS/2 application. Our toolkits provide 200+ functions, 
with the following capabilities: importing and exporting of 40+ file. 


formats, rich image processing, region of interest, color conversion, 
fast image compression, scrolling, zooming, dithering, printing, 
scanning, data base support and annotations. With our new internal 

modular design, you can select the components you need for your 
specific development scenario and keep the size of your application to 
minimum. The toolkits provide both high-level and low-level 
functions, and ships with example application source code. 

If you need imaging, you need LEADTOOLS. 


“LEADTOOLS is an indespensable tool - we 


“LEADTOOLS is a fine example of excellent 

used it in the development of our FrontPage 


technical skills, marketing, and good design 

application." 


combining to make an excellent tool. 


- Tom Button, Director of Marketing, 
Internet Platform & Tools Division, 
Microsoft Corp., 7/96 


- Dan Rogers, 

VB Tech Journal, 
June, 1996 


Download FREE 
imaging application built with 
NEW LEADTOOLS 6! 
or call 

800 - 637-1847 


WINDOWS 95 I WINDOWS NT I WIN32S 


WINDOWS 

| ° s/2 ! 

DOS 



VBX 

| OCX 16/32 

DLL 16/32 


| Everything You Need To Know About Imaging 


http://www.leadtools.com/ 


▼ 


L UMMo ) _ 


900 Baxter St. Charlotte, NC 28204 704-332-5532 Fax:704-372-8161 CompuServe: "GO LEADTECH" 
LEADTOOLS is available in several versions, not oil features are available in all versions. 

• license required from Unisys Iw foimols using LZW compression LEAD ond IEADTOOIS ore mastered Itodemodis o! IUD technologies, Inc. All other pcodud nomes ore Itodemocks of then lespedive owneis 
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C/C++ 

MFC 

1 VISUAL BASIC 


ACCESS 

DELPHI 

VISUAL FOXPRO 









































































